Skip to main content
Glama

MCP Outlook Tools

by wmoto-ai
MIT License
3

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

  1. Clone the repository:
git clone https://github.com/wmoto-ai/mcp-outlook-tools.git cd mcp-outlook-tools
  1. Install dependencies using uv:
uv pip install -e .

Or using pip:

pip install -e .

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

{ "mcpServers": { "outlook-tools": { "command": "uv", "args": [ "--directory", "C:/path/to/mcp-outlook-tools", "run", "--with-editable", ".", "-m", "outlook_tools.server" ], "cwd": "C:/path/to/mcp-outlook-tools", "env": { "PYTHONIOENCODING": "utf-8" } } } }

Usage

Once configured, the following tools are available in your AI assistant:

add_appointment

Add a new appointment to Outlook calendar Parameters: - subject: Appointment title - start_time: Start datetime (YYYY-MM-DD HH:MM) - end_time: End datetime (YYYY-MM-DD HH:MM) - location: Meeting location (optional) - description: Detailed description (optional) - categories: Comma-separated categories (optional) - busy_status: 0=Free, 1=Tentative, 2=Busy, 3=Out of Office (default: 1)

get_calendar

Get calendar items for a date range Parameters: - start_date: Start date (YYYY-MM-DD) - end_date: End date (YYYY-MM-DD)

send_email

Send an email via Outlook Parameters: - to: Recipient email addresses (semicolon-separated) - cc: CC recipients (semicolon-separated) - subject: Email subject - body: Email body text

Project Structure

mcp-outlook-tools/ ├── src/ │ └── outlook_tools/ │ ├── __init__.py │ ├── server.py # MCP server implementation │ ├── calendar_service.py # Calendar operations │ └── search_service.py # Email search operations ├── test/ # Test files ├── pyproject.toml # Project configuration └── README.md # This file

Development

Running Tests

pytest test/

Type Checking

pyright src/

Linting

ruff check src/

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
-
security - not tested
A
license - permissive license
-
quality - not tested

A Model Context Protocol server that enables AI assistants to interact with Microsoft Outlook for calendar management, email operations, and search functionality.

  1. Features
    1. Requirements
      1. Installation
        1. Configuration
          1. For Claude Desktop
        2. Usage
          1. add_appointment
          2. get_calendar
          3. send_email
        3. Project Structure
          1. Development
            1. Running Tests
            2. Type Checking
            3. Linting
          2. Security Notes
            1. Limitations
              1. Contributing
                1. License
                  1. Acknowledgments

                    Related MCP Servers

                    • -
                      security
                      F
                      license
                      -
                      quality
                      A 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 -
                      2
                      Python
                      • Apple
                      • Linux
                    • -
                      security
                      F
                      license
                      -
                      quality
                      A 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
                    • -
                      security
                      F
                      license
                      -
                      quality
                      A 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 -
                      2
                      Python
                      • Linux
                      • Apple
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that enables AI assistants to manage meeting data, including creating meeting bots, searching transcripts, and organizing calendar events.
                      Last updated -
                      16
                      TypeScript
                      MIT License
                      • Apple

                    View all related MCP servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/wmoto-ai/mcp-outlook-tools'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server