Outlook Graph MCP Plus
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
outlook-graph-mcp-plus
Microsoft 365 Outlook as a local MCP server for Claude (Desktop and Code): mail, folders, attachments, calendar and Microsoft To Do, through Microsoft Graph.
Works with Microsoft 365 work and school accounts. Each organisation uses its own app registration in its own Entra ID tenant.
Delegated sign-in only: each user signs in once and the server can reach only that user's own mailbox, calendar and tasks. There's no client secret and no access to other mailboxes.
Runs on the user's computer (macOS, Windows, Linux). Outlook doesn't need to be installed. Tokens stay in the operating system's secret store.
Offers the same 28 tools, with the same names, as its sibling project outlook-desktop-mcp-plus, which controls a locally installed Outlook instead, plus
list_mailboxesfor shared mailboxes.
Status: alpha (0.2.1). All 29 tools have been tested against a real Microsoft 365 tenant (including sending, to the tester's own address), plus unit tests against a simulated Microsoft Graph. Shared mailboxes are new in 0.2 and were tested live as well.
1. For the Microsoft 365 administrator: app registration
You do this once per organisation, in the Microsoft Entra admin center.
Go to Entra ID → App registrations → New registration.
Name: for example
Claude Outlook (MCP).Supported account types: Accounts in this organizational directory only (single tenant).
Redirect URI: platform Public client/native (mobile & desktop), value
http://localhost.Click Register.
In Authentication, under Advanced settings, set Allow public client flows to Yes. This enables the device-code fallback for users without a local browser.
In API permissions → Add a permission → Microsoft Graph → Delegated permissions, add:
User.ReadMail.ReadWriteMail.SendCalendars.ReadWriteTasks.ReadWriteOnly if users should work with shared mailboxes: also
Mail.ReadWrite.Shared,Mail.Send.SharedandCalendars.ReadWrite.Shared.
Then click Grant admin consent for <your organisation>, so users aren't asked to consent individually.
Note the Application (client) ID and the Directory (tenant) ID from the Overview page and give both to your users. They aren't secret.
No client secret or certificate is needed.
Optional hardening
Limit who can use it: in Enterprise applications → (the app) → Properties, set Assignment required to Yes, then assign the users or groups who may use it.
Conditional Access applies to the browser sign-in (MFA, compliant device, and so on). If your policies block the device code flow, users simply sign in with the browser.
Revoking access: remove the user's assignment or delete the app registration. Existing refresh tokens stop working.
Related MCP server: Office MCP Server
2. For each user: install, sign in, connect Claude
Install (Python 3.12+ via uv):
uv tool install outlook-graph-mcp-plusUntil the first PyPI release, install from GitHub:
uv tool install git+https://github.com/lord-helicon/outlook-graph-mcp-plusSign in once. Use the two IDs from your administrator. A browser window opens for the normal Microsoft sign-in:
OUTLOOK_GRAPH_CLIENT_ID=<application-client-id> OUTLOOK_GRAPH_TENANT_ID=<tenant-id> outlook-graph-mcp-plus authOn a machine without a browser, add --device-code. You then open a URL on any device and enter the code it shows. outlook-graph-mcp-plus status shows who is signed in, and outlook-graph-mcp-plus logout removes the cached tokens. On Windows PowerShell, set the variables first with $env:OUTLOOK_GRAPH_CLIENT_ID="...".
Connect Claude Code:
claude mcp add outlook-graph -e OUTLOOK_GRAPH_CLIENT_ID=<application-client-id> -e OUTLOOK_GRAPH_TENANT_ID=<tenant-id> -- outlook-graph-mcp-plusConnect Claude Desktop (Settings → Developer → Edit Config, claude_desktop_config.json):
{
"mcpServers": {
"outlook-graph": {
"command": "outlook-graph-mcp-plus",
"env": {
"OUTLOOK_GRAPH_CLIENT_ID": "<application-client-id>",
"OUTLOOK_GRAPH_TENANT_ID": "<tenant-id>"
}
}
}
}If Claude can't find the command, use the full path shown by which outlook-graph-mcp-plus (macOS and Linux) or where outlook-graph-mcp-plus (Windows). Restart Claude afterwards.
Configuration
Variable | Required | Meaning |
| yes | Application (client) ID of the organisation's app registration |
| yes | Directory (tenant) ID or domain, for example |
| no | The only folder attachments are saved into (default |
| no | IANA timezone for dates (default: the computer's timezone) |
| no | Where the sign-in state is kept (default |
| no | Shared mailboxes this user may work with, for example |
| no |
|
Tools
Area | Tools |
Mailboxes |
|
| |
Drafts |
|
Attachments |
|
Calendar |
|
Tasks (Microsoft To Do, default list) |
|
Notes on the tools:
Folders: standard names work in any Outlook language:
inbox,sent,drafts,deleted,junk,archive,outbox. Custom folders are given by name. If a name exists more than once, give the path, for exampleInbox/Projects, or/Projectsfor a top-level folder.Moving:
move_emailgives the email a newentry_id.Dates: inputs take
YYYY-MM-DD,YYYY-MM-DD HH:MMorDD.MM.YYYY [HH:MM]. Outputs are ISO 8601 in your timezone.
Shared mailboxes
Mail and calendar tools take an optional mailbox parameter, for example list_emails(mailbox="info@contoso.com"). Empty means the user's own mailbox. Here's what it needs and how it behaves:
Admin: the three
.Sharedpermissions above, with admin consent.Exchange: the user needs Full Access to the shared mailbox. Sending from it also needs Send As. Microsoft refuses anything the user isn't allowed to do.
Configuration: list the mailbox in
OUTLOOK_GRAPH_SHARED_MAILBOXES, for example inclaude mcp add ... -e OUTLOOK_GRAPH_SHARED_MAILBOXES=info@contoso.com. If the administrator granted admin consent, the shared permissions are picked up automatically. Otherwise runoutlook-graph-mcp-plus authonce more. Use the mailbox's primary email address as shown in the Exchange admin center. Microsoft Graph can't list which mailboxes a user may open, so they must be named. The list also stops text in an email from steering the model into another mailbox.Ids: an
entry_idonly works with the mailbox it came from.list_mailboxestells the model which mailboxes exist.Tasks: Microsoft To Do doesn't support shared mailboxes, so the task tools always use the user's own.
Security
Delegated access: no application permissions and no secrets. The server acts only as the signed-in user, within the permissions the administrator granted.
Tokens: kept in the macOS Keychain, Windows DPAPI or Linux libsecret. A plaintext cache is only used when explicitly allowed.
Network: the server only contacts
login.microsoftonline.comandgraph.microsoft.com. There's no telemetry.Attachments: only ever saved inside the attachment folder:
The path is resolved before checking, so symlinks and
..can't escape it.Network and device paths are refused before they're touched.
Sender-chosen file names are cleaned, and existing files are never overwritten.
Saved files are marked as downloaded from the internet (Windows Mark-of-the-Web, macOS quarantine).
Ids from mailbox content are validated and URL-encoded, so they can't redirect a request to another Graph endpoint.
Third-party content: email subjects, bodies and attachment names come from outside your organisation. A model can be steered by text in an email ("prompt injection"). The server tells the model to treat such content as data and to confirm before sending, replying, moving or deleting. Keep those confirmations switched on in your Claude client.
Development
uv sync --group dev
uv run pytest -q
uv run ruff check src tests && uv run black --check src testsLicense
MIT, © 2026 Alexander Rolli.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
Permissioned access to Outlook, OneDrive and Teams via the user's own Microsoft account
Mac & Windows: let ChatGPT, Claude & Cursor use your email, calendar, iMessage, Teams, files.
Connect any IMAP/SMTP mailbox to Claude & ChatGPT: search, read, sort, draft. Sends only with OK.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides Claude Desktop and Claude Code with access to Microsoft 365 email and calendar services via the Microsoft Graph API. It enables users to manage emails, search folders, schedule calendar events, and check availability through natural language commands.-
- AlicenseNot gradedqualityCmaintenanceConnects Claude with Microsoft 365 services such as Email, Calendar, Teams, OneDrive, and more through the Microsoft Graph API.81 npm17MIT
- FlicenseAqualityBmaintenanceEnables Claude to manage Outlook calendar events and Microsoft To Do tasks for a specific mailbox via Microsoft Graph API.7-
- AlicenseAqualityCmaintenanceGives Claude Code access to Outlook Mail, Calendar, and Contacts via Microsoft Graph, with safety-first defaults (no sending, no hard deletes, every mutation logged). Supports multiple Microsoft accounts through a PKCE OAuth flow.21MIT