Mcp Outlook

Name: Mcp Outlook
Author: sssSofiaS

@sssSofiaS

About Mcp Outlook

A lightweight MCP Server for seamless integration with Microsoft Outlook, enabling MCP clients to interact with emails for specific users. Developed by sofias tech.

#mcp-outlook #microsoft-outlook #email-integration

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "outlook": {
      "command": "uvx",
      "args": [
        "mcp-outlook"
      ],
      "env": {
        "ID_CLIENT": "your-app-id",
        "APP_SECRET": "your-app-secret",
        "TENANT_ID": "your-tenant-id"
      }
    }
  }
}

Tools

Retrieves a specific email by its unique ID.

Searches emails using OData filter syntax (e.g., "subject eq 'Update'", "isRead eq false") across multiple folders.

Downloads emails within a specific date range using ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ).

Creates a new draft email with the specified subject, body, and recipients.

Updates an existing draft email specified by its ID.

Deletes an email by its ID (moves it to the Deleted Items folder).

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.