# Outlook Assistant

> Outlook Assistant is an open-source MCP server for communication. Outlook mail, calendar and contacts for assistants, with dry-run sends and an allowlist. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI
- **Website:** https://littlebearapps.com/builds/outlook-assistant
- **Repository:** https://github.com/littlebearapps/outlook-assistant
- **MCP Registry name:** io.github.littlebearapps/outlook-assistant
- **Categories:** communication, productivity
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/outlook-assistant
