Email Agent Mcp

Name: Email Agent Mcp
Author: UseJunior

@UseJunior

Repository

About Email Agent Mcp

Email connectivity for AI agents — MCP server for Claude Code, Gemini CLI, Cursor, and more

#mail #mcp #ai-agent #microsoft-365 #outlook #model-context-protocol #openclaw

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "email-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "email-agent-mcp"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Email Agent Mcp?

Email Agent Mcp is an open-source TypeScript MCP server that lets AI agents (Claude Code, Cursor, Gemini CLI, OpenClaw, and others) read, search, draft, reply, label, mark read, move, and send email through your own mailbox. It supports Microsoft 365/Outlook and Gmail with security-first defaults that prevent agents from sending email until you explicitly configure an allowlist.

How to use Email Agent Mcp?

Run npx -y email-agent-mcp to start the interactive setup wizard, which walks you through OAuth configuration and mailbox selection. Then add the server to your MCP client’s settings (e.g., Claude Code settings.json, Cursor .cursor/mcp.json, or Gemini CLI). For OpenClaw, configure an mcp block in ~/.openclaw/openclaw.json. An optional email watcher polls your mailbox and sends wake signals to OpenClaw when new email arrives.

Key features of Email Agent Mcp

15 MCP tools for reading, writing, and managing email
Send allowlist empty by default; agents cannot send until configured
Delete disabled by default; requires explicit operator opt-in
Error sanitization that strips API keys, file paths, and stack traces
Body file sandboxing with path traversal protection
Outbound attachments via file path or inline base64 (25 MB cap)

Use cases of Email Agent Mcp

AI agents reading and summarizing recent email from your mailbox
Drafting and sending email replies under allowlist control
Full-text search across mailboxes for relevant threads
Labeling, flagging, moving, and deleting emails (with security gates)
Monitoring a mailbox for new messages and triggering agent workflows

FAQ from Email Agent Mcp

Does this work with Claude Code?

Yes. Run npx email-agent-mcp to start the MCP server, then configure it in your Claude Code settings.

Can agents send email without my permission?

No. The send allowlist is empty by default. Agents cannot send any email until you explicitly configure allowed recipients.

Does this store my email credentials?

OAuth tokens are managed by MSAL (Microsoft) and stored in your OS keychain or local config files under ~/.email-agent-mcp/. Agent Email never stores raw passwords.

Can I connect multiple mailboxes?

Yes. You can configure Microsoft 365 and Gmail simultaneously. Read actions default to your primary mailbox; write actions require specifying a mailbox when multiple are configured.

The OpenClaw CLI rejects my config with "Unrecognized key: mcp"

The OpenClaw CLI and macOS app can be different versions. The app may support config keys the CLI doesn't recognize yet. Update the CLI with npm install openclaw@latest in your NemoClaw directory, or restart the gateway directly.