Agent Email MCP Server

Local email connectivity for AI agents - read, draft, send, and organize Outlook mail via MCP.

People connecting email tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-20 · ★ 5 · #15 OF 75 MAINTAINED EMAIL · VERIFIED 2026-08-25

Apache-2.0 · TypeScript servers · how we verify → /methodology

01 · Install Agent Email

before you install - you'll need

Set AGENT_EMAIL_ALLOWED_DIRS, OPENCLAW_HOOKS_TOKEN, EMAIL_AGENT_MCP_HOME, AGENT_EMAIL_SEND_ALLOWLIST, EMAIL_AGENT_MCP_SCOPE_PROFILE, AGENT_EMAIL_GMAIL_CLIENT_ID, AGENT_EMAIL_GMAIL_CLIENT_SECRET before connecting.

Claude Code

claude mcp add usejunior-email-agent-mcp -- npx -y email-agent-mcp

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

npm package email-agent-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.UseJunior is GitHub-verified and matches the repo owner

03 · What Agent Email can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 2 documented tools across body format, body truncated, including bodyFormat, bodyTruncated.

The 2 tools it gives your agent

Extracted from the project's README - what Agent Email lets an agent do.

bodyFormat: - always present: markdown, html, or text. You get text
bodyTruncated: - present and true only if the body exceeded the 256 KB

Latest releases

v0.3.0 · 2026-08-14

Other Changes · allow operator-configured attachment roots · derive reply recipients when to is omitted (closes #192) · bump workspace versions to 0.3.0

v0.2.0 · 2026-08-13

Other Changes · stop observe-profile serve path from hanging on an unconsented scope set · ignore Office lock files (~$) · never auto-retry non-idempotent delivery operations · populate EMAIL_ACTIONS as an explicit…

v0.1.11 · 2026-08-05

Other Changes · verify published dependency chain · add production secret helper · label unsent drafts in read results · add opt-in raw-HTML output to read_email · document body_file frontmatter and unsanitised html…

04 · Who maintains Agent Email

Agent Email is maintained by usejunior. We track 2 MCP servers from usejunior - 2 actively maintained, 43 combined GitHub stars, oldest repo from Feb 2026. Full record: all servers from usejunior.

Safe Docx AI-native surgical editing of Word .docx and OpenDocument .odt files with formatting preservation ★ 38

05 · Facts

repository: github.com/usejunior/email-agent-mcp
website: https://github.com/UseJunior/email-agent-mcp
category: email - ranked #15 of 75 actively-maintained email servers as of 2026-08-25.
release cadence: 5 releases in the last 90 days (latest 2026-08-14)
registry: io.github.UseJunior/email-agent-mcp (active, first published 2026-04-04 · 11 versions)
packages: npm:email-agent-mcp

06 · Agent Email FAQ

What is Agent Email?

Local email connectivity for AI agents - read, draft, send, and organize Outlook mail via MCP.

Is Agent Email still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-20 and it shipped 5 releases in the last 90 days. We re-verify nightly.

How do I install Agent Email?

Run `npx -y email-agent-mcp`. The README documents 7 environment variables (AGENT_EMAIL_ALLOWED_DIRS, OPENCLAW_HOOKS_TOKEN, EMAIL_AGENT_MCP_HOME…) to set first. Set AGENT_EMAIL_ALLOWED_DIRS, OPENCLAW_HOOKS_TOKEN, EMAIL_AGENT_MCP_HOME, AGENT_EMAIL_SEND_ALLOWLIST, EMAIL_AGENT_MCP_SCOPE_PROFILE, AGENT_EMAIL_GMAIL_CLIENT_ID, AGENT_EMAIL_GMAIL_CLIENT_SECRET before connecting. You can also paste the ready-made client config above.

Does Agent Email run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Agent Email

Alternatives to Agent Email

Maintained email servers if Agent Email isn't the fit.

More email MCP servers · Thunderbird CLI · Proofpoint · Launch Engine - Business Execution OS · Palmyr · Google Workspace (aaronsb)

More TypeScript MCP servers · Safe Docx · Kaneo · Notra · OrgX MCP - Organizational Continuity for AI Agents · Valv · see all