Skip to main content

Model Context Protocol (MCP) server for automated Outlook Calendar scheduling with automatic Microsoft Teams meeting link generation

Project description

SWAPNIL MCP Server 🚀

A specialized Model Context Protocol (MCP) server implementation for automating Outlook Calendar scheduling with Microsoft Teams integration

License Python Version MCP Outlook Teams Code style: black

📋 Overview

SWAPNIL MCP Server is a robust implementation of the Model Context Protocol that provides seamless integration with Microsoft Outlook Calendar and Teams. It enables AI models to create and schedule meetings directly in Outlook Calendar with automatic Microsoft Teams meeting link generation. The server leverages the Model Context Protocol (MCP) to expose this functionality to AI models through a standardized interface.

🛠️ Setup & Installation

Requirements

  • Python 3.9 or higher
  • Microsoft Outlook (installed on the system)
  • Microsoft Teams (for Teams meeting integration)
  • Internet connection (proxy support available)

Quick Start

# Install the package
pip install swapnil-mcp-server

# Start the server
python -m mcp_tools

🧰 Available MCP Tools

This server exposes a powerful tool through the Model Context Protocol interface:

📅 Outlook Calendar

Set_Meeting - Create and schedule a meeting in Microsoft Outlook with Teams integration
async def Set_Meeting(subject: str, start_date: str, end_date: str, use_teams: bool = True) -> str

Parameters:

  • subject: Meeting subject
  • start_date: Start date and time in ISO format (e.g., "2023-10-01T10:00:00")
  • end_date: End date and time in ISO format (e.g., "2023-10-01T11:00:00")
  • use_teams: Whether to create a Teams meeting (default: True)

Returns:

  • A confirmation message with meeting details

Example:

# Schedule a team meeting with Microsoft Teams integration
result = await Set_Meeting(
    "Team Weekly Sync", 
    "2023-10-01T10:00:00", 
    "2023-10-01T11:00:00",
    use_teams=True
)
print(result)  # Meeting with subject 'Team Weekly Sync' set from 2023-10-01T10:00:00 to 2023-10-01T11:00:00. Microsoft Teams meeting link has been created.

📋 Detailed Usage Guide

Configuration

No specific environment variables are required to run the server. However, Microsoft Outlook must be installed and configured on the system.

Running the Server

Start the server with the following command:

python -m mcp_tools

Integration with MCP Clients

Connect using any MCP-compatible client. Here's a simple Python example:

from mcp.client import Client

async def main():
    # Connect to the SWAPNIL MCP Server
    client = await Client.connect("http://localhost:8000")
    
    # Schedule a meeting
    meeting_result = await client.Set_Meeting(
        "Team Retrospective",
        "2023-10-15T14:00:00",
        "2023-10-15T15:00:00"
    )
    print(meeting_result)

🔍 Troubleshooting

Common issues and solutions:

  • Connection errors: Ensure the server is running and accessible
  • Outlook integration issues: Verify Outlook is installed and properly configured
  • Proxy issues: Check your network settings and proxy configuration

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

⚖️ License

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


Built with ❤️ for enhancing AI-powered communication

MCP SpecificationMicrosoft OutlookFastAPI

Author: Swapnil Dagade LinkedIn

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.2.tar.gz (5.6 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.2-py3-none-any.whl (6.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: swapnil_mcp_server-6.0.2.tar.gz
  • Upload date:
  • Size: 5.6 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.2.tar.gz
Algorithm Hash digest
SHA256 02a06814eef5bb6cb2fa85b8bb1bf4a7cbdaed462edfb747922c67d175a7db75
MD5 fd502217c39f058067f97c801fb20a9f
BLAKE2b-256 ae7d923a1a191cd7554014fa04cbbb91304f510602b2431e26154e81ad95de1b

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for swapnil_mcp_server-6.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d0411e06db32dd70007425744634f145178a10b30199a71ab926123da9bbb8fb
MD5 146c84b5af211324951e1245228a08f0
BLAKE2b-256 43d3d3ee130a6bacd7503a03c10f0075abfc20d10de0aca0a7275b1c6455cba2

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