MCP Outlook

@sssSofiaS

Basic information

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

MCP Outlook 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"
      }
    }
  }
}

MCP Outlook 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.

Frequently asked questions

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.

Comments

More Communication MCP servers

SomaCheck Vibecheck

Sensie-agents

Body language for AI agents, on your terms. A consented three-second phone gesture gives your agent an Aligned or Unaligned signal with confidence. You remain the authority.

Instant Expert

Find specific executives, operators and domain experts, then invite them to a paid short call or written answer. You pay only if they book or answer.

Soprano Connect MCP Server

soprano-mcp

Soprano Connect MCP Server enables you to build AI agents that can communicate, engage customers, and manage communications workflows through the Soprano Connect platform using the Model Context Protocol (MCP).

MailStream

Sponge Labs

The first MCP server for physical mail. Give any MCP-compatible AI agent the ability to send real postcards and letters, verify addresses, manage mailing lists and artwork, and track direct mail campaigns. Remote Streama

Vocenya

GH Business Solutions

Connect an AI assistant to one Vocenya business account: list calls, leads, bookings and chats, add leads, queue compliant AI callbacks and update Do Not Call.https://github.com/gadyamedia/vocenya-mcp