Outlook by pepebits MCP Server

Search Outlook email through pepebits’ community MCP server using Microsoft Graph. Enable OUTLOOK_READ_ONLY to remove mutating tools.

Local serverstdio

What is the Outlook by pepebits MCP Server?

This community Outlook MCP server connects a local assistant to Microsoft Graph mail tools. It is maintained by pepebits and is separate from a Microsoft-published MCP integration.

Start with inbox research

A focused request can find messages from a sender about a named project and summarize the matching conversation. Include dates and message context in the answer. Set OUTLOOK_READ_ONLY=true when the task only needs inspection; the documented mode removes mutating tools such as sending, moving and deleting messages.

Use the right Microsoft account flow

The npm package @pepebits/outlook-mcp requires Node.js 24 or later. Its login tool provides a device-code sign-in flow. The shared Azure app supports personal Microsoft accounts by default; work or school accounts require the documented custom Azure application and tenant configuration. Authentication tokens are kept locally through the project’s token-store mechanisms.

Setup and tool documentation. Explore related MCP servers.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
loginStart the Microsoft device-code sign-in flow.

How to install the Outlook by pepebits MCP Server

{
  "mcpServers": {
    "outlook": {
      "command": "npx",
      "args": [
        "-y",
        "@pepebits/outlook-mcp"
      ],
      "env": {
        "OUTLOOK_READ_ONLY": "true"
      }
    }
  }
}

Ask the assistant to log in to Outlook, then complete the device-code flow. Configure your own Azure app for a work or school account.

Configuration

Node.js 24+ and a Microsoft account. Work or school accounts need your own Azure application configuration.

VariableDescriptionRequired
OUTLOOK_READ_ONLYSet true to remove mutating email tools.Optional

Example prompts to try

  • “Find messages about the renewal from this sender during September and summarize them without changing the inbox.”

Frequently asked questions

No. This listing covers pepebits’ community implementation using Microsoft Graph.