Mcp Outlook
@sssSofiaS
A lightweight MCP Server for seamless integration with Microsoft Outlook, enabling MCP clients to interact with emails for specific users. Developed by sofias tech.
Overview
What is Mcp Outlook?
Mcp Outlook is a lightweight MCP server for seamless integration with Microsoft Outlook, enabling MCP clients to interact with emails for specific users. It provides operations for reading, searching, creating, updating, and deleting emails via the Microsoft Graph API.
How to use Mcp Outlook?
Install via pip (pip install mcp-outlook) or uv, configure environment variables for your Azure AD app credentials, and set up the MCP client (e.g., Claude Desktop) with the proper JSON configuration. Each tool requires a user_email parameter to specify which mailbox to access.
Key features of Mcp Outlook
- Retrieve a specific email by its unique ID.
- Search emails using OData filter syntax.
- Download emails within a specified date range.
- Create, update, and delete draft emails.
- Access multiple user mailboxes through application permissions.
- Modular design with clear separation of concerns.
Use cases of Mcp Outlook
- Get emails from last week for a given user.
- Search for emails with a specific subject line.
- Create a draft email for a user to send to their team.
- Delete an email from a user’s inbox.
FAQ from Mcp Outlook
What permissions does Mcp Outlook require?
Microsoft Graph API application permissions: Mail.ReadWrite, Mail.Send, and User.Read, with admin consent at the organization level.
How is Mcp Outlook configured?
Create a .env file with ID_CLIENT (client ID), APP_SECRET (client secret), and TENANT_ID (tenant ID). The user email is passed as a parameter per tool, not as an environment variable.
What is the runtime requirement for Mcp Outlook?
Python 3.10+ and dependencies listed in pyproject.toml.
How do I integrate Mcp Outlook with Claude Desktop?
Add an mcpServers entry to the Claude Desktop config file (claude_desktop_config.json) using command: "mcp-outlook" (or uvx with arguments) and the required environment variables.
