Outlook MCP

Name: Outlook MCP
Author: Little Bear Apps

Inbox meets AI

Give Claude full access to your Outlook email, calendar, and contacts.

20 consolidated tools across 9 modules for email, calendar, contacts, folders, rules, settings, and shared mailboxes. Talks directly to Microsoft Graph — no middleman, no cloud sync.

Releasedv2.0.0

Get Started View on GitHub

What it does

Everything you'd normally do in Outlook, but from Claude

Email management

Read, search, send, and organise emails. Export full threads as Markdown, EML, MBOX, JSON, or HTML.

Export an email thread as Markdown for documentation

Calendar and scheduling

View upcoming events, create meetings, decline invites, search meeting rooms — all through conversation.

Check your next meeting's details without opening Outlook

Contact and people search

Full CRUD for contacts plus relevance-based people search across your organisation.

Find a colleague's contact info by asking Claude

Mailbox automation

Create inbox rules, manage categories, configure Focused Inbox overrides, set automatic replies.

Create inbox rules to auto-sort incoming mail

What Outlook MCP includes

Email — search, read, send, export
6 tools covering search, read with forensic headers, send with dry-run mode, update flags, attachments, and export to 5 formats (Markdown, EML, MBOX, JSON, HTML).
Calendar and scheduling
List events, create meetings with attendees and rooms, decline or cancel invites.
Contacts and people search
Full CRUD for personal contacts plus relevance-based people search across your organisation.
Categories and Focused Inbox
Create categories with custom colours, apply to messages, and configure Focused Inbox overrides.
Folders, rules, and settings
Create folders, manage inbox rules in natural language, configure auto-replies and working hours.
Shared mailboxes and meeting rooms
Access shared mailboxes and search available meeting rooms in your organisation.
Safety-first design
MCP annotations for auto-approve on reads, dry-run mode for sends, session rate limiting, and recipient allowlists.
Token-optimised architecture
20 consolidated tools instead of 55 — reduces per-turn overhead by ~11,000 tokens (~64%), keeping more context for your conversation.
OAuth2 authentication
Browser-based OAuth with automatic token refresh. Scoped to your account, revocable any time.

How it works

Your AI agent talks directly to Microsoft Graph. I'm not in the middle.

Direct to Microsoft

OAuth delegated permissions

Free and open source

20 tools, token-optimised

What exactly does it access?

What it accesses

Your Outlook mailbox via Microsoft Graph API (delegated permissions)
Email, calendar, contacts, and settings you explicitly grant access to

Where it stores

OAuth tokens: ~/.outlook-mcp-tokens.json

Delete ~/.outlook-mcp-tokens.json to revoke local tokens

Network calls

Microsoft Graph API (graph.microsoft.com)
No Little Bear Apps servers involved

Remove from MCP config to disable

Set up with any AI agent

Copy this prompt — your AI agent handles the rest

Works with:

Claude Desktop

Claude Code

Codex CLI

Gemini CLI

OpenCode

Cursor

VS Code

I want to install the Outlook MCP server (https://github.com/littlebearapps/outlook-mcp). Please guide me step-by-step, including the Azure app registration.

🔧

Azure Setup Guide Required before first use

📖

Full Documentation

Manual configuration per agent

Windows/MacOS/Linux

Terminal

IDE

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "outlook": {
      "command": "npx",
      "args": ["-y", "@littlebearapps/outlook-mcp"],
      "env": {
        "OUTLOOK_CLIENT_ID": "your-azure-client-id",
        "OUTLOOK_CLIENT_SECRET": "your-azure-client-secret"
      }
    }
  }
}

Restart Claude Desktop after saving. Then ask Claude to authenticate — it will open a browser window for Microsoft sign-in.

CLI command or .mcp.json

claude mcp add outlook -- npx -y @littlebearapps/outlook-mcp

Set OUTLOOK_CLIENT_ID and OUTLOOK_CLIENT_SECRET as environment variables first. Run this command, then verify with /mcp.

~/.codex/config.toml

[mcp_servers.outlook]
command = "npx"
args = ["-y", "@littlebearapps/outlook-mcp"]
env = { "OUTLOOK_CLIENT_ID" = "your-azure-client-id", "OUTLOOK_CLIENT_SECRET" = "your-azure-client-secret" }

Save config and restart Codex CLI. Use the authenticate tool to complete Microsoft sign-in.

~/.gemini/settings.json

{
  "mcpServers": {
    "outlook": {
      "command": "npx",
      "args": ["-y", "@littlebearapps/outlook-mcp"],
      "env": {
        "OUTLOOK_CLIENT_ID": "your-azure-client-id",
        "OUTLOOK_CLIENT_SECRET": "your-azure-client-secret"
      }
    }
  }
}

Save config and restart Gemini CLI. Use the authenticate tool to complete Microsoft sign-in.

~/.cursor/mcp.json

{
  "mcpServers": {
    "outlook": {
      "command": "npx",
      "args": ["-y", "@littlebearapps/outlook-mcp"],
      "env": {
        "OUTLOOK_CLIENT_ID": "your-azure-client-id",
        "OUTLOOK_CLIENT_SECRET": "your-azure-client-secret"
      }
    }
  }
}

Add via Cursor Settings → MCP → Add Server, or edit ~/.cursor/mcp.json directly.

.vscode/mcp.json

{
  "mcpServers": {
    "outlook": {
      "command": "npx",
      "args": ["-y", "@littlebearapps/outlook-mcp"],
      "env": {
        "OUTLOOK_CLIENT_ID": "your-azure-client-id",
        "OUTLOOK_CLIENT_SECRET": "your-azure-client-secret"
      }
    }
  }
}

Add to .vscode/mcp.json in your project or user MCP settings.

Ready to go? Try these prompts

Copy any of these into your AI agent with Outlook MCP

"Show me my unread emails from today"

Great first test — reads your inbox

"What meetings do I have this week?"

Checks your Outlook calendar

"Search my emails for invoices from last month"

Uses email search with date filtering

"I was tired of copying emails into Claude conversations just to get help drafting replies or summarising threads."

—

Nathan Founder

Where to find Outlook MCP

IssuesReport bugs

DocumentationGuides & API reference

SecuritySecurity policy

npmNode package

View on GitHub

Questions about Outlook MCP

Does Outlook MCP store or send my emails to Little Bear Apps?

No. All data flows directly between Claude and Microsoft via the Graph API. Little Bear Apps never sees, stores, or processes your email content.

Does this work with personal Outlook.com and work/school Microsoft 365?

Yes. Outlook MCP supports both personal Microsoft accounts (Outlook.com, Hotmail) and work/school Microsoft 365 accounts. Work accounts may require admin consent.

Is the Azure app registration free?

Yes. Azure app registration and Microsoft Graph API delegated calls are free. Azure requires a payment method on file, but the services used by Outlook MCP incur no charges.

What permissions does it need?

Delegated permissions only — Mail.ReadWrite, Mail.Send, Calendars.ReadWrite, Contacts.ReadWrite, MailboxSettings.ReadWrite, People.Read, Place.Read.All, and User.Read. These are scoped to your account and revocable at any time.

Does this work with Claude.ai or mobile apps?

No. MCP servers require a desktop client (Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI, Gemini CLI, or OpenCode) that can run local processes. Web-based interfaces and mobile apps don't support MCP.

Can I access shared mailboxes?

Yes. Outlook MCP includes shared mailbox tools for listing emails and sending on behalf of shared mailboxes you have access to.

What export formats are supported?

Five formats: EML/MIME (forensics and archival), MBOX (batch archive), Markdown (human-readable), JSON (programmatic), and HTML (visual archival).

How do I revoke access?

Delete ~/.outlook-mcp-tokens.json locally, and revoke the app from your Microsoft account at account.microsoft.com → Privacy → Apps and services.

What safety features does Outlook MCP include?

Dry-run mode previews email sends before actually sending, session rate limiting prevents runaway tool calls, recipient allowlists restrict who emails can be sent to, and MCP annotations let clients auto-approve read-only operations while prompting for writes.

Why 20 tools instead of 55?

The original 55 tools were consolidated into 20 using the STRAP (Single Tool, Resource, Action Pattern) approach. This reduces per-turn token overhead by ~11,000 tokens (~64%), improves tool selection accuracy, and keeps more of your context window available for conversation.

What changes

• Instead of copying emails into Claude to draft replies, let Claude read and write directly from your mailbox.
• Instead of switching to Outlook to check your calendar before scheduling, ask Claude to find free slots and create the meeting.
• Instead of manually exporting emails for documentation, ask Claude to export a thread as Markdown or EML in one step.
• Instead of navigating Outlook settings to set up rules, describe the rule in natural language and Claude creates it.
• Instead of searching through your contacts app, ask Claude to find the person by name, role, or department.

Roadmap

Coming Soon

Exploring: Calendar improvements and recurring event support
Exploring: Teams chat integration
Exploring: Batch operations for bulk email management

Changelog

v2.0.0 — v2.0.0 - Initial Public Release

1 month ago

nathanschram

•MCP server for Microsoft Outlook via Graph API - 55 tools across 9 modules.
•List, search, read, send emails
•Attachments: list, download, view content
•Headers & MIME for forensics/archival

See release details on GitHub

Also by Little Bear Apps

PitchDocs 10 slash commands that generate READMEs, changelogs, roadmaps, and AI context files from your codebase. Untether Run Claude Code, OpenCode, or Codex CLI from Telegram. Voice notes, multi-project routing, and persistent sessions.

← Back to All Tools

Outlook MCP

What it does

Email management

Calendar and scheduling

Contact and people search

Mailbox automation

What Outlook MCP includes

Email — search, read, send, export

Calendar and scheduling

Contacts and people search

Categories and Focused Inbox

Folders, rules, and settings

Shared mailboxes and meeting rooms

Safety-first design

Token-optimised architecture

OAuth2 authentication

How it works

What it accesses

Where it stores

Network calls

Set up with any AI agent

Ready to go? Try these prompts

Where to find Outlook MCP

Questions about Outlook MCP

What changes

Roadmap

Coming Soon

Changelog