Outlook MCP Server

Email & Calendar via MCP for Claude and Cursor

22 Tools · v0.3.0
Sign in with Microsoft
Features

What can it do?

Email (12 Tools)

  • Inbox Fetch recent emails with pagination
  • Read Read a single email in full
  • Search Search by keyword, sender, or date
  • Draft Create a new email draft
  • Reply Draft Create a reply draft to an existing email
  • Flagged Flagged / follow-up emails
  • Triage Quick overview: unread, flagged, oldest
  • Folders List mail folders (including nested sub-folders) with unread/total counts
  • Move Move an email to another folder
  • Archive Archive an email (move to Archive folder)
  • Folder Create Create a new mail folder or sub-folder
  • Folder Delete Delete a folder safely (messages moved to parent or Inbox first)

📅 Calendar (5 Tools)

  • Events View events for today, this week, or a custom range
  • Create Create a new event with attendees
  • Free/Busy Check availability of people
  • Shared View another person's calendar
  • Respond Accept or decline invitations

+ 5 Auth & Attachment Tools

Auth Start — Generate an OAuth login URL for Microsoft sign-in
Auth Status — Check if the current session is authenticated
Attachment Read — Extract text from PDF, DOCX, XLSX, images (sender must be approved in browser first)
Whitelist List — Show approved senders for attachment access
Whitelist Revoke — Remove an approved sender

Limitations

What can it not do (yet)?

  • No direct email sending (drafts only — user confirms in Outlook)
  • No attachment uploads (read-only — and only from senders you approve in a browser)
  • No folder rename (delete is supported with mail-safety; create + move + delete only)
  • Cannot permanently delete emails (moving them to the Deleted Items folder is possible)
  • No editing or deleting existing calendar events
  • No contact access
Setup

Installation

  1. Sign in with Microsoft (button above) — you’ll land on a page with your personal URL.
  2. In Claude Cowork: Settings → Connectors → “Add custom connector”.
  3. Name: Outlook. Paste your personal URL from the success page as the server URL.
https://mcp-outlook.swarm-test.ci.alpha.pet/mcp?t=<your-token>

The <your-token> part is generated after you sign in — just copy the full URL from the success page.

  1. Sign in with Microsoft (button above) — copy the CLI command from the success page.
  2. Paste it into your terminal:
claude mcp add --transport http outlook --scope user \
  "https://mcp-outlook.swarm-test.ci.alpha.pet/mcp?t=<your-token>"

That’s it — Outlook tools show up in your next Claude Code session.

Config file: ~/.claude.json (macOS/Linux) · %USERPROFILE%\.claude.json (Windows)
  1. Sign in with Microsoft (button above) — copy the JSON snippet from the success page.
  2. Paste it into mcpServers in your global MCP config:
"outlook": {
  "url": "https://mcp-outlook.swarm-test.ci.alpha.pet/mcp?t=<your-token>"
}

Restart Cursor — Outlook tools are available immediately.

Config file: ~/.cursor/mcp.json (macOS/Linux) · %USERPROFILE%\.cursor\mcp.json (Windows)
How it works

Three steps, then you’re set

You only do this once — after that the connection stays alive for roughly 90 days of regular use.

1

Sign in with Microsoft

Click the button above, sign in with your @alpha.pet account, grant access

→
2

Copy your personal URL

The success page shows a ready-to-paste URL for each client (Cowork / Code / Cursor)

→
3

Paste into your MCP client

Tools show up in the next chat — no extra in-chat auth step needed