Outlook MCP — Claude Code MCP server: features and setup
Connects a personal Microsoft Outlook account to an AI agent for handling mail, calendar events, contacts, tasks, and drafts.
claude mcp add outlook-mcp -- uvx outlook-graph-mcpWhat Outlook MCP does
Outlook MCP connects an agent to a personal Outlook account through the Microsoft Graph API. It can search and read messages, sort mail, create and send messages, and manage calendar events, contacts, tasks, folders, attachments, and drafts.
The server exposes tools the agent can combine into a workflow, such as finding a message and preparing a reply. To add it to Claude Code, run claude mcp add outlook-mcp -- uvx outlook-graph-mcp.
This server works with personal Microsoft accounts such as @outlook.com, @hotmail.com, and @live.com. Work and school accounts are unsupported, so they won’t connect through this server.
What it helps with
- search messages by topic or content
- sort incoming mail into folders
- prepare a draft reply to a message
- check calendar events and add an appointment
- create a task with checklist items
Example prompts for the agent
- Find recent unread messages and flag anything urgent.
- Draft a reply to the latest message from my colleague.
- Check my calendar and create a task to prepare travel documents.
How to install Outlook MCP
Platform CLI
claude mcp add outlook-mcp -- uvx outlook-graph-mcpuvx runs the command named after the package; if the README names another one, use uvx --from outlook-graph-mcp <command>
Platform CLI
codex mcp add outlook-mcp -- uvx outlook-graph-mcpuvx runs the command named after the package; if the README names another one, use uvx --from outlook-graph-mcp <command>
Config file
{
"mcpServers": {
"outlook-mcp": {
"command": "uvx",
"args": [
"outlook-graph-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from outlook-graph-mcp <command>
Config file
{
"servers": {
"outlook-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"outlook-graph-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from outlook-graph-mcp <command>
Platform CLI
gemini mcp add outlook-mcp uvx outlook-graph-mcpuvx runs the command named after the package; if the README names another one, use uvx --from outlook-graph-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Outlook MCP
How do I install Outlook MCP in Claude Code?
Run claude mcp add outlook-mcp -- uvx outlook-graph-mcp. This adds the server under the name outlook-mcp.
What does Outlook MCP do?
It gives an AI agent tools for managing mail, calendar events, contacts, tasks, and drafts in a personal Outlook account through Microsoft Graph API.
Does Outlook MCP support Microsoft 365 work accounts?
No. It is for personal Outlook, Hotmail, and Live accounts; work and school accounts aren’t supported.
