Microsoft 365 Mail MCP Server

Microsoft 365 Outlook Mail MCP server - list, search, read, send, reply, forward, draft, move, and delete email, download attachments, read threads, triage (read/flag), and manage out-of-office replies via the Microsoft Graph API. Its 22 documented tools cover email, draft, emails, reply.

People connecting productivity tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

One of 41 MCP servers published from mindstone/mcp-servers. Stars and repository activity are shared across all of them. See all 41 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-19 · VERIFIED 2026-08-25

NOASSERTION · TypeScript servers · how we verify → /methodology

01 · Install Microsoft 365 Mail

before you install - you'll need

Set MS_CLIENT_ID, MS_CONFIG_DIR, MS_MCP_PACKAGE_ID, MICROSOFT_REQUEST_TIMEOUT_MS before connecting.

Claude Code

claude mcp add mindstone-mcp-servers-connectors-microso -- npx -y @mindstone/mcp-server-microsoft-mail

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "mindstone-mcp-servers-connectors-microso": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-microsoft-mail"
      ]
    }
  }
}

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 no standard license detected - usage rights unclear; check the repo before commercial use

npm package @mindstone/mcp-server-microsoft-mail - published under the repo owner's npm scope (@mindstone)

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

03 · What Microsoft 365 Mail 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 list emails in a folder, ordered by most recent (see ordering note below), read a single email by message ID, list attachment metadata (ID, name, type, size) for a message, and save a file attachment into the workspace (or OS temp directory).

Capability map

Tools grouped from the project's README - what Microsoft 365 Mail lets an agent do.

9 tools - e.g. Read a single email by message ID.; Send a new email message (supports CC and BCC).; Open an editable draft in an interactive compose view; nothing is sent until the user clicks Send, and Save draft…

get_email · send_email · compose_email · reply_to_email · forward_email · delete_email…

read & search

3 tools - e.g. List attachment metadata (ID, name, type, size) for a message.; List messages in a thread, oldest first (see ordering note below).; List mail folders.

list_attachments · get_conversation · list_folders

Draft

3 tools - e.g. Save a new standalone draft email (supports CC and BCC).; Send an existing draft.; Update a draft's subject, body, recipients, or importance.

create_draft · send_draft · update_draft

Emails

2 tools - e.g. List emails in a folder, ordered by most recent (see ordering note below).; Search emails using Microsoft Search syntax.

list_emails · search_emails

Automatic

2 tools - e.g. Read the out-of-office configuration (requires MailboxSettings.Read).; Turn out-of-office replies on/off or schedule them (requires MailboxSettings.ReadWrite).

get_automatic_replies · set_automatic_replies

auth & access

1 tool - e.g. Emit the structured auth_required handoff so the host runs the Microsoft 365 OAuth flow.

authenticate_microsoft_account

Download

1 tool - e.g. Save a file attachment into the workspace (or OS temp directory).

download_attachment

1 tool - e.g. Save a draft reply to an existing email.

create_reply_draft

04 · Who maintains Microsoft 365 Mail

Microsoft 365 Mail is maintained by mindstone. We track 41 MCP servers from mindstone - 41 actively maintained, 10 combined GitHub stars, oldest repo from Apr 2026. Full record: all servers from mindstone.

05 · Facts

repository: github.com/mindstone/mcp-servers
category: productivity - actively maintained as of 2026-08-25.
registry: io.github.mindstone/mcp-server-microsoft-mail (active, first published 2026-05-21 · 4 versions)
packages: npm:@mindstone/mcp-server-microsoft-mail

06 · Microsoft 365 Mail FAQ

Is Microsoft 365 Mail still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-19. We re-verify nightly.

What can Microsoft 365 Mail do?

How do I install Microsoft 365 Mail?

Run `npx -y @mindstone/mcp-server-microsoft-mail`. The README documents 4 environment variables (MS_CLIENT_ID, MS_CONFIG_DIR, MS_MCP_PACKAGE_ID…) to set first. Set MS_CLIENT_ID, MS_CONFIG_DIR, MS_MCP_PACKAGE_ID, MICROSOFT_REQUEST_TIMEOUT_MS before connecting. You can also paste the ready-made client config above.

Does Microsoft 365 Mail run locally?

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

07 · Alternatives to Microsoft 365 Mail

Alternatives to Microsoft 365 Mail

Maintained productivity servers if Microsoft 365 Mail isn't the fit.

Pairs well with

Servers that cover what Microsoft 365 Mail doesn't - only shown when the pairing reason fits the companion.

More productivity MCP servers · Microsoft 365 SharePoint · Microsoft 365 Teams · Mixmax · Nano Banana · Napkin