MCP Outlook Tools
A Model Context Protocol (MCP) server implementation that enables AI assistants to interact with Microsoft Outlook for calendar management, email operations, and search functionality.
Features
- 📅 Calendar Management
- Get calendar items within a date range
- Add new appointments with full details
- Support for categories and busy status
- 📧 Email Operations
- Send emails with To/CC recipients
- Display confirmation before sending
- Full body formatting support
- 🔍 Email Search
- Search emails by date and keyword
- Extract user information from addresses
- Japanese text encoding support
Requirements
- Windows OS (required for pywin32)
- Microsoft Outlook installed and configured
- Python 3.10 or higher
- MCP-compatible AI assistant (e.g., Claude Desktop)
Installation
- Clone the repository:
- Install dependencies using uv:
Or using pip:
Configuration
For Claude Desktop
Add the following to your Claude Desktop configuration file:
Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Usage
Once configured, the following tools are available in your AI assistant:
add_appointment
get_calendar
send_email
Project Structure
Development
Running Tests
Type Checking
Linting
Security Notes
- This tool requires access to your local Outlook installation
- Emails are displayed before sending for user confirmation
- No credentials are stored in the code
- All operations use Windows COM interface with existing Outlook authentication
Limitations
- Windows only (due to pywin32 dependency)
- Requires Outlook to be installed and configured
- Time zone handling assumes JST (+9 hours)
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Acknowledgments
- Built with FastMCP framework
- Uses pywin32 for Outlook COM interface
This server cannot be installed
A Model Context Protocol server that enables AI assistants to interact with Microsoft Outlook for calendar management, email operations, and search functionality.
Related MCP Servers
- -securityFlicense-qualityA versatile Model Context Protocol server that enables AI assistants to manage calendars, track tasks, handle emails, search the web, and control smart home devices.Last updated -2Python
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to interact with Gmail services, supporting email operations, draft management, and calendar functionality through Google API integration.Last updated -TypeScript
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to access and manage email through IMAP, supporting browsing, searching, reading, and organizing emails while learning user preferences over time.Last updated -2Python
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants to manage meeting data, including creating meeting bots, searching transcripts, and organizing calendar events.Last updated -16TypeScriptMIT License