Outlook MCP - install, status & alternatives [2026]

01 · Install Outlook MCP

before you install - you'll need

Set SSL_CERT_FILE, REQUESTS_CA_BUNDLE before connecting. OUTLOOK_MCP_TOOLSETS is optional or environment-specific per the README.

Claude Code

claude mcp add mpalermiti-outlook-mcp -- uvx outlook-graph-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "mpalermiti-outlook-mcp": {
      "command": "uvx",
      "args": [
        "outlook-graph-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package outlook-graph-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.mpalermiti is GitHub-verified and matches the repo owner

03 · What Outlook MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can check if authenticated and whether read-only mode is active, search mail using KQL query. Optionally scope to a folder by name or ID, list mail folders with counts, parent_id, and child_count. Pass recursive=true to walk the full folder tree (subfolders included), and list only inbox changes since the last call. First call returns a full snapshot plus a delta_token.

Capability map

Tools grouped from the project's README - what Outlook MCP lets an agent do.

Outlook

39 tools - e.g. List messages in a folder. folder accepts display names, well-known names, or Graph IDs. Filter by read status, sender, date range, Focused Inbox classification; Get full message by ID. Format: text…

outlook_list_inbox · outlook_read_message · outlook_read_messages · outlook_search_mail · outlook_list_folders · outlook_list_inbox_delta…

auth & access

1 tool - e.g. Check if authenticated and whether read-only mode is active.

outlook_auth_status

Latest releases

v1.12.0 · 2026-07-19

Tier-0 performance & efficiency pass for recurring agent loops (personal-account mail + calendar). No new tools, no breaking changes; default surface unchanged (62 tools). · Highlights · Concurrent digest…

v1.11.1 · 2026-07-18

Fixed - outlook_download_attachment corrupted binary attachments (#25) · outlook_download_attachment raised UnicodeDecodeError on any attachment whose bytes aren't valid UTF-8 - in practice every non-text file (.pdf…

v1.11.0 · 2026-05-23

Added - Bulk message read via $batch (1 tool) · One new MCP tool: outlook_read_messages(message_ids, format="text", concise=False, include_deferred_send=False). Reads up to 20 messages by ID in a single Graph $batch…

04 · Who maintains Outlook MCP

Outlook MCP is maintained by mpalermiti. It's the only MCP server we track from this author; the repo dates to Apr 2026.

05 · Facts

repository: github.com/mpalermiti/outlook-mcp
website: https://github.com/mpalermiti/outlook-mcp
category: email - actively maintained as of 2026-08-25.
release cadence: 2 releases in the last 90 days (latest 2026-07-19)
registry: io.github.mpalermiti/outlook-mcp (active, first published 2026-04-13 · 18 versions)
packages: pypi:outlook-graph-mcp

06 · Outlook MCP FAQ

Is Outlook MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-19 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can Outlook MCP do?

With this server connected, an agent can check if authenticated and whether read-only mode is active, search mail using KQL query. Optionally scope to a folder by name or ID, list mail folders with counts, parent_id, and child_count. Pass recursive=true to walk the full folder tree (subfolders included), and list only inbox changes since the last call. First call returns a full snapshot plus a delta_token.

How do I install Outlook MCP?

Run `uvx outlook-graph-mcp`. The README documents 3 environment variables (SSL_CERT_FILE, REQUESTS_CA_BUNDLE, OUTLOOK_MCP_TOOLSETS) to set first. Set SSL_CERT_FILE, REQUESTS_CA_BUNDLE before connecting. OUTLOOK_MCP_TOOLSETS is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Outlook MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Outlook MCP

Alternatives to Outlook MCP

Maintained email servers if Outlook MCP isn't the fit.

More email MCP servers · iCloud MCP · Multimail Dev MCP Server · Better Email MCP · Clippy · Maket

More Python MCP servers · Plots · SourceWeave Web Search · Gsc Indexer MCP · Agent Bom · Allure Testops MCP · see all