outlook

This MCP server provides programmatic access to Microsoft Outlook functionality through a standardized MCP interface. It exposes tools to explore mail folders, list and search emails, view full email content (including attachments), compose new messages, and reply to existing emails. Clients like Claude Desktop can discover available operations and invoke them to read and manage your Outlook mailbox within an MCP-enabled workflow. The server abstracts Outlook interactions behind simple tool names, enabling LLMs to perform tasks such as listing folders, retrieving recent emails, searching by keywords or contacts, and performing common email actions without direct Outlook scripting.

To use it, start the server (for example, by configuring your MCP client to launch the Python script) and then call the provided tools through the MCP interface. The available tools include list_folders, list_recent_emails, search_emails, get_email_by_number, reply_to_email_by_number, and compose_email. Use these tools in sequence to explore your mailbox, find relevant messages, and respond or draft new messages as needed.

Prerequisites:

• Windows operating system
• Python 3.10 or later
• Microsoft Outlook installed and configured with an active account
• An MCP-compatible client (e.g., Claude Desktop)

Installation steps:

1. Clone or download this repository to your local machine.
2. Install required dependencies:

pip install mcp>=1.2.0 pywin32>=305

3. Configure your MCP client to use this server. For Claude Desktop, add a server entry in MCP_client_config.json similar to:

{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["Your path\\outlook_mcp_server.py"],
      "env": {}
    }
  }
}

4. Start the server via the MCP client or run the server script directly:

python outlook_mcp_server.py

Tips and considerations:

• Prerequisites emphasize a Windows environment with Outlook installed due to pywin32 usage; ensure Outlook is configured with an active account.
• The server currently supports text emails (HTML not listed as supported) and retains a 30-day history limit.
• If you encounter permission or connection issues, verify that the script has access to Outlook and that Outlook is running and connected.
• When constructing search queries, leverage OR operators to combine terms for more flexible filtering.
• This MCP server requires careful handling of credentials and access rights since it can read, send, and manage emails; use only with trusted clients in secure environments.