Skip to main content

Model Context Protocol (MCP) server for automated Outlook Calendar meeting scheduling

Project description

Swapnil MCP Server

PyPI version Python Versions License: MIT

A Model Context Protocol (MCP) server that provides automated Outlook Calendar scheduling.

Features

  • Create and schedule meetings in Microsoft Outlook calendar
  • Set custom meeting properties (subject, location, body)
  • Configure reminder settings and busy status
  • Simple API accessible through MCP clients
  • Retrieve meeting details
  • Cancel scheduled meetings

Installation

pip install swapnil-mcp-server

Requirements

  • Python 3.9 or higher
  • Windows OS (requires Microsoft Outlook and optionally Microsoft Teams)
  • pywin32 package
  • mcp package version 1.2.0 or higher

Usage

Starting the Server

# Run as a command
swapnil-mcp-server

# Or import in your Python code
from mcp_tools.server import mcp
mcp.run()

Using with MCP Clients

This package implements the Model Context Protocol (MCP), allowing AI assistants and other MCP-compatible clients to interact with your Outlook calendar.

Example of how an MCP client might use this tool:

from mcp.client import Client

client = Client()
result = await client.Set_Meeting(
    subject="Team Meeting",
    start_date="2023-10-01T10:00:00",
    end_date="2023-10-01T11:00:00"
)
print(result)  # Meeting with subject 'Team Meeting' set from 2023-10-01T10:00:00 to 2023-10-01T11:00:00.


## API Reference

### Set_Meeting

Creates and schedules a meeting in Microsoft Outlook.

**Parameters:**

- `subject` (string, required): Meeting subject
- `start_date` (string, required): Start date and time in ISO format (e.g., "2023-10-01T10:00:00")
- `end_date` (string, required): End date and time in ISO format (e.g., "2023-10-01T11:00:00")

**Returns:**

- A confirmation message with the meeting details

### Get_Meeting

Retrieves details of a scheduled meeting.

**Parameters:**

- `meeting_id` (string, required): The unique identifier of the meeting

**Returns:**

- Meeting details including subject, start time, end time, and participants

### Cancel_Meeting

Cancels a scheduled meeting in Microsoft Outlook.

**Parameters:**

- `meeting_id` (string, required): The unique identifier of the meeting

**Returns:**

- A confirmation message indicating the meeting has been canceled

## Development

### Project Structure

swapnil-mcp-server/ ├── src/ │ └── mcp_tools/ │ ├── init.py │ ├── main.py │ └── server.py ├── LICENSE ├── README.md └── pyproject.toml


### Building and Publishing

```bash
python -m build
python -m twine upload dist/*

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

swapnil_mcp_server-6.0.9.tar.gz (4.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

swapnil_mcp_server-6.0.9-py3-none-any.whl (5.3 kB view details)

Uploaded Python 3

File details

Details for the file swapnil_mcp_server-6.0.9.tar.gz.

File metadata

  • Download URL: swapnil_mcp_server-6.0.9.tar.gz
  • Upload date:
  • Size: 4.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for swapnil_mcp_server-6.0.9.tar.gz
Algorithm Hash digest
SHA256 8a5981a8296d32956485d524eebed52418a8aa8462cc7b7eb612f523a3fa01d8
MD5 f9d78de0ab0c7b5061ba17f49cd25af4
BLAKE2b-256 392cb9309c5abbb67d764cba944f62c5ebc22920a8d659c36faf5d474fba1b07

See more details on using hashes here.

File details

Details for the file swapnil_mcp_server-6.0.9-py3-none-any.whl.

File metadata

File hashes

Hashes for swapnil_mcp_server-6.0.9-py3-none-any.whl
Algorithm Hash digest
SHA256 bffa0bce5613188aca4204cfb290cdb38ed98f7ecaa23ac6a5242a351b64bc57
MD5 71494efef3dce0dd417f79e7bf595e53
BLAKE2b-256 9494f350f318af5c61d5ed3d5de6c890d3bdc08ae43d06d09380129d06ea016c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page