Metadata-Version: 2.4
Name: swapnil-mcp-server
Version: 6.2.2
Summary: Model Context Protocol (MCP) server for automated Outlook Calendar meeting scheduling
Author-email: swapnil dagade <swapnildagade@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/swapnildagade/swapnil-mcp-server
Project-URL: Bug Tracker, https://github.com/swapnildagade/swapnil-mcp-server/issues
Project-URL: Documentation, https://github.com/swapnildagade/swapnil-mcp-server#readme
Keywords: mcp,model-context-protocol,outlook,calendar,meeting,scheduling,automation,microsoft-outlook
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Office/Business :: Scheduling
Classifier: Topic :: Communications :: Conferencing
Classifier: Environment :: Win32 (MS Windows)
Classifier: Intended Audience :: Information Technology
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.2.0
Requires-Dist: pywin32>=223
Requires-Dist: datetime
Requires-Dist: requests
Dynamic: license-file

# Swapnil MCP Server

[![PyPI version](https://img.shields.io/pypi/v/swapnil-mcp-server.svg)](https://pypi.org/project/swapnil-mcp-server/)
[![Python Versions](https://img.shields.io/pypi/pyversions/swapnil-mcp-server.svg)](https://pypi.org/project/swapnil-mcp-server/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

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

## Features

- Create and schedule meetings in Microsoft Outlook calendar
- Retrieves current weather information for a specified city using OpenWeatherMap

## Installation

```bash
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

```bash
# 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:

```python
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_weather

Retrieves current weather information for a specified city using OpenWeatherMap.

**Parameters:**
- `city` (string, required): Name of the city (any global city)

**Returns:**
- Dictionary with location, temperature, humidity, wind, description, and timestamp

---

## Available Tools

| Tool         | Description                                      |
|--------------|--------------------------------------------------|
| Set_Meeting  | Create and schedule meetings in Outlook          |
| get_weather  | Get weather information for a city               |

## 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](LICENSE) file for details.

## Author

- Swapnil Dagade (swapnildagade@gmail.com)

## Links

- [GitHub Repository](https://github.com/swapnildagade/swapnil-mcp-server)
- [Bug Tracker](https://github.com/swapnildagade/swapnil-mcp-server/issues)
- [Documentation](https://github.com/swapnildagade/swapnil-mcp-server#readme)
