Skip to content
MCP server

Outlook Assistant

Outlook mail, calendar and contacts for assistants, with dry-run sends and an allowlist

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
self-hosted, CLI
Runs
Locally
Version
3.14.2
Listing updated
1 day ago

About Outlook Assistant

Outlook Assistant is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

This server connects an assistant to a personal Outlook.com or work or school Microsoft 365 account. Its 22 tools cover searching and reading mail, drafting, replying and sending, exporting threads, running the calendar and contacts, setting inbox rules and categories and configuring out-of-office replies. It also reads raw message headers such as DKIM, SPF and DMARC for phishing checks, tracks changes with delta sync and searches meeting rooms by building, capacity and equipment.

Sending is guarded by a dry-run preview, pre-send mail tips, session rate limiting and a recipient allowlist, and there is a read-only mode. Threads export to Markdown, EML, MBOX, JSON, HTML or CSV. A retried calendar create cannot book the same meeting twice. Shared mailboxes can be read and organised on Microsoft 365, but sending from them is not supported.

It runs locally via npx over stdio. Sign-in defaults to a device-code flow with an Azure AD client ID, and the browser flow also takes a client secret. The authors say it uses 64% fewer tokens than before.

Install

Run in a terminal

claude mcp add outlook-assistant --env OUTLOOK_CLIENT_SECRET='<OUTLOOK_CLIENT_SECRET>' -- npx -y @littlebearapps/outlook-assistant

Add to claude_desktop_config.json

{
  "mcpServers": {
    "outlook-assistant": {
      "command": "npx",
      "args": [
        "-y",
        "@littlebearapps/outlook-assistant"
      ],
      "env": {
        "OUTLOOK_CLIENT_SECRET": "<OUTLOOK_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "outlook-assistant": {
      "command": "npx",
      "args": [
        "-y",
        "@littlebearapps/outlook-assistant"
      ],
      "env": {
        "OUTLOOK_CLIENT_SECRET": "<OUTLOOK_CLIENT_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "outlook-assistant": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@littlebearapps/outlook-assistant"
      ],
      "env": {
        "OUTLOOK_CLIENT_SECRET": "<OUTLOOK_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "outlook-assistant": {
      "command": "npx",
      "args": [
        "-y",
        "@littlebearapps/outlook-assistant"
      ],
      "env": {
        "OUTLOOK_CLIENT_SECRET": "<OUTLOOK_CLIENT_SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "outlook-assistant": {
      "command": "npx",
      "args": [
        "-y",
        "@littlebearapps/outlook-assistant"
      ],
      "env": {
        "OUTLOOK_CLIENT_SECRET": "<OUTLOOK_CLIENT_SECRET>"
      }
    }
  }
}

Configuration

  • OUTLOOK_CLIENT_IDAzure AD application (client) ID. Optional: if it is not set here, supply it at sign-in with the auth tool (action=authenticate clientId=<id>)
  • OUTLOOK_CLIENT_SECRETAzure AD application client secret value. Only needed for the browser sign-in flow; the default device-code flow doesn't use it

What it does

Mail search and read
Filter by sender, date, keyword, folder, status and attachments.
Guarded sending
Dry-run preview, allowlist and rate limiting.
Thread export
Save conversations in six formats.
Calendar management
Create, update, decline and cancel meetings and find rooms.
Inbox rules
Create and reorder rules with 12 condition and 9 action types.
Header forensics
Read DKIM, SPF, DMARC and delivery headers.

Good for

  • Summarise unread mail and draft replies
  • Schedule a meeting and find a free room
  • Export a legal thread to MBOX
  • Set up an inbox rule from a plain-language request

Pricing

Open source

Free server; needs a Microsoft account and Azure AD app

Prices change. Check littlebearapps.com before you buy.

Outlook Assistant FAQ

Does it work with personal accounts?

Yes, Outlook.com and work or school Microsoft 365 accounts.

Can it send mail by mistake?

Safeguards include dry-run previews, a recipient allowlist and a read-only mode.

How do I sign in?

The default device-code flow needs an Azure AD client ID; a browser flow also needs a client secret.

How many tools are there?

22.

Is Outlook Assistant free?

Yes. Outlook Assistant is open source, so you can use and self-host it for free.

How do I add Outlook Assistant to Claude Code?

Run this command in your terminal: claude mcp add outlook-assistant --env OUTLOOK_CLIENT_SECRET='<OUTLOOK_CLIENT_SECRET>' -- npx -y @littlebearapps/outlook-assistant

What are the best alternatives to Outlook Assistant?

The closest alternatives to Outlook Assistant are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

Alternatives to Outlook Assistant

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  5. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  6. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media