Skip to main content

MCP server to expose some tools for LLMs

Project description

SWAPNIL MCP Server 🚀

A powerful Model Context Protocol (MCP) server implementation for Outlook Calendar integration

License Python Version MCP Outlook Code style: black

📋 Overview

SWAPNIL MCP Server is a robust implementation of the Model Context Protocol that provides seamless integration with Microsoft Outlook Calendar. It enables AI models to create and schedule meetings through a standardized interface.

🛠️ Setup & Installation

Requirements

  • Python 3.9 or higher
  • Microsoft Outlook (installed on the system)
  • 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
async def Set_Meeting(subject: str, start_date: str, end_date: str) -> 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")

Returns:

  • A confirmation message with meeting details

Example:

# Schedule a team meeting
result = await Set_Meeting(
    "Team Weekly Sync", 
    "2023-10-01T10:00:00", 
    "2023-10-01T11:00:00"
)
print(result)  # Meeting with subject 'Team Weekly Sync' set from 2023-10-01T10:00:00 to 2023-10-01T11:00:00.

📋 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.1.tar.gz (5.4 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.1-py3-none-any.whl (6.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: swapnil_mcp_server-6.0.1.tar.gz
  • Upload date:
  • Size: 5.4 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.1.tar.gz
Algorithm Hash digest
SHA256 eb0b47f99c5908c775d841eb7a25215ff2ec55d384c13169c3b5d6d27c746649
MD5 aa07163ee3cf742b397331e88d24bed0
BLAKE2b-256 2e954c02448b82ad02417e834ebd5192eefd51c62ce6d334ffe76d0a9f432c9d

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for swapnil_mcp_server-6.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 525dc5919390a55316d7f396c14c26b739f5b4f7e24d23746d00cc20ceb6fe0a
MD5 1319f4ba2f704c8a602041296f28b8e4
BLAKE2b-256 fa0f69d9e6b1d284a4aaeac249860459bbe42797e77fe3f0a6f2925d468d432b

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