Outlook Assistant logo

Outlook Assistant

by littlebearapps

Connects AI assistants to Outlook for email, calendar, contacts, mailbox settings, folders, rules, exports, and shared mailboxes.

Install Outlook Assistant

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "littlebearapps-outlook-assistant": {
      "command": "npx",
      "args": [
        "-y",
        "@littlebearapps/outlook-assistant"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 22 tools correctly (18d ago).

Overview

littlebearapps/outlook-assistant MCP server connects AI assistants to personal Outlook.com and work or school Microsoft 365 accounts through MCP. It provides consolidated tools for searching and managing email, drafting and sending messages, scheduling events, managing contacts, exporting conversations, and configuring mailbox features. Safety controls include dry-run previews, mail tips, rate limiting, and recipient allowlists for sending. Reach for it when an agent needs to work with Outlook data without switching to the Outlook interface.

Use cases

  • Search and summarize Outlook email threads
  • Draft and review replies before sending
  • Schedule and update calendar meetings
  • Export messages or conversations for analysis
  • Organize folders, categories, and inbox rules

Key features

  • Search, read, draft, send, and export email
  • Manage calendar events and meeting invitations
  • Create and update contacts
  • Configure folders, rules, categories, and mailbox settings
  • Inspect forensic email headers
  • Access and organize shared Microsoft 365 mailboxes

Tools22

What Outlook Assistant lets your agent do. Expand a tool for its parameters.

Verified live~14.5k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

19/19 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · @littlebearapps/outlook-assistant (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars39Stargazers on the source repository.
npm downloads2kPackage downloads in the last 30 days.
Last commit6d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed22Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How Outlook Assistant works

What littlebearapps/outlook-assistant MCP server does

littlebearapps/outlook-assistant exposes Microsoft Outlook email, calendar, contacts, and mailbox administration through the Model Context Protocol. It supports both personal Outlook.com accounts and work or school Microsoft 365 accounts, though some capabilities vary by account type.

Email operations include searching by sender, subject, date, or keywords; reading messages and threads; changing flags and read status; moving messages; applying categories; and handling attachments. Agents can create, update, send, delete, reply to, and forward drafts. Calendar tools cover event discovery, creation, updates, declines, cancellations, and deletion. Contacts can be searched and maintained, including searches against the organisational directory.

The server also covers folders, inbox rules, categories, Focused Inbox, automatic replies, working hours, time zone settings, and meeting-room searches. Messages and conversations can be exported in formats including Markdown, EML, JSON, CSV, MBOX, and HTML, depending on the export target.

How it works

An MCP-compatible client invokes the server's tools from an assistant conversation. The implementation groups its functionality into 22 consolidated tools rather than exposing the larger underlying operation set. The auth tool reports authentication status and supports authentication-related actions, while the remaining tools operate on the connected Outlook account.

Search supports ordinary filtering and, where available, Microsoft 365 free-text search. Delta synchronization can return new, changed, and deleted messages since a previous check by using continuation tokens. Conversation-aware operations let an agent work with complete threads instead of treating every message as unrelated.

Sending includes safeguards intended to make outbound actions reviewable. Dry-run mode can preview an operation, mail tips can report conditions such as out-of-office settings or delivery restrictions, session rate limiting limits repeated sends, and a recipient allowlist can restrict destinations.

Setup and configuration

The server requires access to a Microsoft account through Outlook. The repository states that personal Outlook.com and work or school Microsoft 365 accounts are supported, with feature differences documented by account type. Use the authentication functionality exposed by the auth tool to inspect or complete the account connection.

Shared mailbox access is optional and applies to work or school Microsoft 365 accounts. Set OUTLOOK_SHARED_MAILBOX to opt into that capability. Shared mailbox operations can enumerate folders, search and read messages, and organise them by moving, flagging, categorising, or creating folders. Sending and draft operations remain tied to the signed-in user's own mailbox.

Meeting-room search is also limited to Microsoft 365 accounts and requires the Place.Read.All permission with administrator consent. Personal accounts do not provide shared mailbox or meeting-room search support.

Tools and capabilities

The littlebearapps/outlook-assistant tool set includes:

  • Email search, reading, header inspection, sending, drafting, updates, attachments, exports, and mail tips.
  • Calendar listing, event creation, and event management.
  • Contact management and people-directory search.
  • Category and Focused Inbox management.
  • Mailbox settings, folder management, and inbox-rule management.
  • Shared mailbox access and meeting-room discovery.
  • Authentication status and authentication actions.

Raw header access includes delivery and authentication details such as DKIM, SPF, DMARC, delivery-chain data, and selected originating or mail-client fields. This can support phishing investigation or compliance review, but the material does not describe an automated verdict system.

Limitations and notes

Personal accounts have limited free-text query behavior and use fallback handling; direct subject, sender, and recipient filters are more suitable there. Focused Inbox API operations work on personal accounts but do not change mail routing. Shared mailbox functionality is read-and-organise only: sending, drafts, replies, and forwards are not supported for that mailbox.

Folder-tree enumeration is best-effort. Results can identify branches skipped because of depth limits or errors in individual folders. Meeting-room search is unavailable for personal accounts and needs administrator-approved Microsoft 365 permissions. Export formats depend on whether the target is one message, a batch of messages, or a conversation thread.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Outlook Assistant

littlebearapps/outlook-assistant is an MCP server that connects AI assistants to Microsoft Outlook accounts through the Model Context Protocol. Its main tools search, read, draft, send, and export email; manage calendar events and contacts; configure mailbox features; organize folders and rules; and optionally access shared Microsoft 365 mailboxes.

It identifies the project as an MCP server distributed through the npm package @littlebearapps/outlook-assistant and says it works with MCP-compatible clients.

Yes, littlebearapps/outlook-assistant works with Cursor. The README also names Claude, Windsurf, GitHub Copilot, and other MCP-compatible clients, so compatibility depends on the client supporting MCP.

Yes, but shared mailbox access is optional and limited to work or school Microsoft 365 accounts. Set OUTLOOK_SHARED_MAILBOX to enable it; the server can read and organize messages and folders, but sending, drafts, replies, and forwards use the signed-in user's mailbox instead.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewOutlook Assistant AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/littlebearapps-outlook-assistant?style=directory)](https://allmcps.com/mcp/littlebearapps-outlook-assistant)
HTML Embed
<a href="https://allmcps.com/mcp/littlebearapps-outlook-assistant"><img src="https://allmcps.com/api/badge/littlebearapps-outlook-assistant?style=directory" alt="Outlook Assistant on AllMCPs" /></a>