Outlook MCP Server
by sofias tech
A lightweight MCP Server for seamless integration with Microsoft Outlook, enabling MCP clients to interact with emails for specific users. It provides a clean interface to Outlook email resources through the Model Context Protocol (MCP).
Last updated: N/A
What is Outlook MCP Server?
The Outlook MCP Server is a lightweight server that allows MCP clients to interact with Microsoft Outlook email resources. It provides tools for reading, searching, creating, updating, and deleting emails through the Model Context Protocol (MCP).
How to use Outlook MCP Server?
To use the server, you need to register an app in Azure AD, grant the necessary Microsoft Graph API permissions, obtain the client ID, tenant ID, and create a client secret. Then, configure the server with these credentials using environment variables and install the package. Finally, you can use the provided tools through an MCP client like Claude, specifying the user email for each operation.
Key features of Outlook MCP Server
Retrieves specific emails by ID
Searches emails using OData filter syntax
Downloads emails within a specific date range
Creates new draft emails
Updates existing draft emails
Deletes emails (moves to Deleted Items)
Accesses multiple user mailboxes
Use cases of Outlook MCP Server
Automating email retrieval for specific users
Searching for emails based on complex criteria
Creating and managing draft emails programmatically
Integrating email functionality into MCP-based applications
Building email-driven workflows
Email data extraction and analysis
FAQ from Outlook MCP Server
What permissions are required for the Azure AD app?
What permissions are required for the Azure AD app?
The Azure AD app requires the following Microsoft Graph API permissions at the application level: Mail.ReadWrite, Mail.Send, and User.Read.
How do I specify which user's mailbox to access?
How do I specify which user's mailbox to access?
The user email is passed as a parameter to each tool, rather than being defined as an environment variable.
What is the purpose of the MCP Inspector?
What is the purpose of the MCP Inspector?
The MCP Inspector is a tool for debugging the MCP server, allowing you to inspect the requests and responses.
What is the Model Context Protocol (MCP)?
What is the Model Context Protocol (MCP)?
The Model Context Protocol (MCP) is a protocol that allows applications to interact with various services and tools in a standardized way.
How do I install the server?
How do I install the server?
You can install the server using pip with the command 'pip install -e .' for development or 'pip install mcp-outlook' once published on PyPI. Alternatively, you can use uv: 'uv pip install mcp-outlook'.