Outlook Tools

You can run a local MCP server that lets an AI assistant manage your Microsoft Outlook tasks, including calendar items, emails, and targeted searches. This enables you to automate routine Outlook workflows directly from your AI workspace while keeping control over execution and confirmations.

How to use

After you configure the MCP server, your AI assistant can access three core capabilities: add appointments to Outlook calendar, retrieve calendar items for a date range, and send emails with built-in confirmation. It can also search your Outlook emails by date or keyword. Use these tools through your MCP client by invoking them with your desired parameters, then letting the assistant perform the action or present options for confirmation.

How to install

Prerequisites you need to install and run the MCP server locally are listed here. Follow the exact commands to ensure your environment matches the expected setup.

Clone the MCP Outlook Tools repository.

git clone https://github.com/wmoto-ai/mcp-outlook-tools.git
cd mcp-outlook-tools

Install dependencies using uv, which runs Python in an isolated environment suitable for MCP servers.

uv pip install -e .

Or install with plain pip if you prefer."

pip install -e .

Configuration

Configure your MCP client (for example Claude Desktop) to run the server as a stdio process. The following settings enable the server to start via uv from your local path.

{
  "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"
      }
    }
  }
}

Security notes

This tool requires access to your local Outlook installation. Emails are displayed for user confirmation before sending. No credentials are stored in the code, and all operations leverage the Windows COM interface with your existing Outlook authentication.

Limitations

Windows-only due to pywin32 dependency. Outlook must be installed and configured. Time zone handling is assumed JST (+9 hours) unless otherwise configured.

Tools and usage notes

Available tools enable direct actions from your AI client. You can add an appointment, fetch calendar items for a date range, and send emails with formatting and detailed fields. You can also perform email searches to locate messages by date or keyword.

Available tools

add_appointment

Add a new appointment to the Outlook calendar with subject, start_time, end_time, location, description, categories, and busy status. The tool supports common calendar fields and offers a default busy status if not specified.

get_calendar

Retrieve Outlook calendar items within a specified start_date and end_date. Useful for planning and summarizing upcoming events.

send_email

Send an email via Outlook with to, cc, subject, and body fields. The body supports full formatting, and a confirmation step is shown before sending.

search_email

Search Outlook emails by date and keyword, with support for extracting user information from addresses and Japanese text encoding where applicable.