Outlook Email MCP Server

A cross-platform MCP server that processes Microsoft Outlook emails, generates vector embeddings using Ollama, and provides semantic search

Local serverstdioPython

What is the Outlook Email MCP server?

Outlook Email becomes available to MCP clients through the outlook email mcp server. A cross-platform MCP server that processes Microsoft Outlook emails, generates vector embeddings using Ollama, and provides semantic search capabilities. Works on Windows, macOS, and any platform via Microsoft Graph API.

What Outlook Email does

A cross-platform MCP server that processes Microsoft Outlook emails, generates vector embeddings using Ollama, and provides semantic search capabilities. Works on Windows, macOS, and any platform via Microsoft Graph API.

Tools it exposes

Once connected, the assistant can call these 2 tools directly:

  • Category — Tools
  • Statistics — get_email_statistics, check_data_consistency

Installing the outlook email mcp server

Setup follows the standard MCP pattern: clone or install the server, then register it in your client's configuration file and restart the client. The configuration snippets on this page cover Claude Desktop, Claude Code and Cursor.

Configuration

Before the server will start you need to supply 8 environment variables: MONGODB_URI, SQLITE_DB_PATH, EMBEDDING_BASE_URL, EMBEDDING_MODEL, COLLECTION_NAME, OUTLOOK_PROVIDER, LOCAL_TIMEZONE, GRAPH_CLIENT_ID. Keep credentials in your client's env block or a secrets manager rather than committing them.

Where it fits

Communication servers earn their keep on volume — summarising channels and threads that would otherwise cost you an hour of scrollback. Outlook Email sits in that group, and the shape of its toolset — Category, Statistics — tells you what it is really for. Worth comparing against the other communication servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

  • This server runs locally, so it operates with whatever access your machine and its credentials already have. Scope that deliberately rather than by default.
  • It will not start until its required credentials are present, so set those before wondering why the tools never appear.
  • Maintained by Cam10001110101, written in Python.
  • MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the outlook email mcp server actually does with your data.
  • Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

Available tools

ToolWhat it does
CategoryTools
Statisticsget_email_statistics, check_data_consistency

How to install the Outlook Email MCP server

{
  "mcpServers": {
    "outlook-email": {
      "command": "C:/path/to/.venv/Scripts/python",
      "args": ["C:/path/to/src/mcp_server.py"],
      "env": {
        "MONGODB_URI": "mongodb://localhost:27017/MCP?authSource=admin",
        "SQLITE_DB_PATH": "C:\\path\\to\\data\\emails.db",
        "EMBEDDING_BASE_URL": "http://localhost:11434",
        "EMBEDDING_MODEL": "nomic-embed-text",
        "COLLECTION_NAME": "outlook-emails",
        "OUTLOOK_PROVIDER": "windows",
        "LOCAL_TIMEZONE": "America/Chicago"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
MONGODB_URIConfiguration value read at startup.Optional
SQLITE_DB_PATHFilesystem location the server is allowed to use.Optional
EMBEDDING_BASE_URLEndpoint or connection string the server talks to.Yes
EMBEDDING_MODELConfiguration value read at startup.Optional
COLLECTION_NAMEConfiguration value read at startup.Optional
OUTLOOK_PROVIDERConfiguration value read at startup.Optional
LOCAL_TIMEZONEConfiguration value read at startup.Optional
GRAPH_CLIENT_IDConfiguration value read at startup.Optional

Example prompts to try

  • Use Outlook Email to Category.
  • Use Outlook Email to Statistics.

Frequently asked questions

It connects Outlook Email to MCP-compatible AI assistants such as Claude and Cursor, exposing 2 tools (Category, Statistics) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Outlook Email directly.