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.2.0.tar.gz (6.0 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.2.0-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: swapnil_mcp_server-6.2.0.tar.gz
  • Upload date:
  • Size: 6.0 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.2.0.tar.gz
Algorithm Hash digest
SHA256 c09a7d1c73564fbaf10742cd46eeba2f856cf84ff8a8c195bbcaf7635ca05ff3
MD5 a012ea279280e74b456ef24c3a2ae35e
BLAKE2b-256 2794e1e248f407a6f5d67a9846c47f47853eaf24b25fb6e1e89307941972a877

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for swapnil_mcp_server-6.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 15ec85fd3c7f00a4b9f73a78034cc816c48f1387cbde03675aff71314d27853c
MD5 a90922f2d6727121951eed5e0c80e77e
BLAKE2b-256 4d6cd120daf2e8b7b6bc0688d0b776c1f3e1efd400d4dc7ed4bf4b19f61d4f66

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