Agent Email MCP Server

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

People who work with Agent and Openclaw and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-08 · ★ 6 · #25 OF 90 MAINTAINED EMAIL · VERIFIED 2026-09-18

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.2 · 2026-09-07

Other Changes · find scheduled sends outside Drafts · bump workspace versions to 0.3.2

v0.3.1 · 2026-09-02

Other Changes · spell out how caller paths resolve against allowed roots · scope the one-ask rule to cold outreach, and repair rule-guardrail citations · use immutable IDs for attachment round trips · narrow default…

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

04 · Who maintains Agent Email

Agent Email is maintained by usejunior. We track 2 MCP servers from usejunior - 2 actively maintained, 48 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 ★ 42

05 · Facts

repository: github.com/usejunior/email-agent-mcp
website: https://github.com/UseJunior/email-agent-mcp
category: email - ranked #25 of 90 actively-maintained email servers as of 2026-09-18.
release cadence: 7 releases in the last 90 days (latest 2026-09-07)
registry: io.github.UseJunior/email-agent-mcp (active, first published 2026-04-04 · 13 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-09-18, its last commit was 2026-09-08 and it shipped 7 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 · Your Mail MCP · Wraps · Proofpoint · Gmail Attachments MCP

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