playbooks

home / mcp / outlook mcp server

Outlook MCP Server

Provides access to Outlook email actions like listing folders, reading, searching, composing, and replying via MCP.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "wallisking1991-outlook-mcp-server": {
      "command": "python",
      "args": [
        "outlook_mcp_server.py"
      ]
    }
  }
}

Outlook MCP Server provides access to Microsoft Outlook email functionality through a Model Context Protocol interface, enabling you to read, search, and manage emails from MCP-compatible clients. This makes it possible to integrate Outlook actions into your workflows with a consistent, programmable surface.

How to use

You connect your MCP client to the Outlook MCP Server to perform common email tasks. Start by launching the server on your Windows machine, then configure your MCP client to point to the local server. Once connected, you can list folders, fetch recent emails, search by terms or contacts, view full email content (including attachments), compose new messages, and reply to existing ones.

How to install

Prerequisites you need before starting:

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

Install the required Python dependencies for the server. Run the following command in your terminal or command prompt:

pip install mcp>=1.2.0 pywin32>=305

Start the server directly once dependencies are installed or configure your MCP client to start it for you. The server runs from the Python script named outlook_mcp_server.py.

python outlook_mcp_server.py

Configuration

Configure your MCP client to connect to the Outlook MCP Server. The following example shows how to register the server with Claude Desktop in the client config file named MCP_client_config.json.

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

Security considerations

This server has access to your Outlook email account and can read, send, and manage emails. Use it only with trusted MCP clients and in secure environments.

Troubleshooting

If you encounter issues, check the following common areas:

  • Outlook is running and configured with an active account
  • The server script has permission to access Outlook
  • Search queries use valid terms and, if needed, OR operators
  • The server process is not crashing and Outlook remains connected

Notes

Limitations include support for text emails only, a 30-day history window, dependence on Outlook’s search, and basic email operations without calendar or contacts features.

Available tools

list_folders

Lists all available mail folders in Outlook.

list_recent_emails

Lists email titles from the specified number of days.

search_emails

Search emails by contact name or keywords with optional OR operators.

get_email_by_number

Retrieves detailed content of a specific email.

reply_to_email_by_number

Replies to a specific email.

compose_email

Creates and sends a new email.