mcpbeat Sign in

mcp-mail MCP Server

local only

mcp-mail runs on your own machine — the client starts it, so there is no endpoint to ping. 577 installs a week from npm. Last commit 3 Nov 2026.

Self-hosted IMAP/SMTP email for any MCP client, with per-client permissions and audit log.

Installs per day peak 426 · avg 19
a month agotoday
577
Installs / week
npm · @annseraf/mcp-mail
0
Stars
0 open issues
3 Nov 2026
Last commit
from GitHub
MIT
License
TypeScript

What the code does

We read the source, 3 d ago · rules 995398eba69f

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

Runs an external command src/update.ts:19
  const r = spawnSync(UPDATER, args.length ? args : ["--check"], { stdio: "inherit" });

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add mcp-mail -- npx -y @annseraf/mcp-mail
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-mail": {
      "command": "npx",
      "args": [
        "-y",
        "@annseraf/mcp-mail"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.mcp-mail]
command = "npx"
args = ["-y", "@annseraf/mcp-mail"]
.cursor/mcp.json
{
  "mcpServers": {
    "mcp-mail": {
      "command": "npx",
      "args": [
        "-y",
        "@annseraf/mcp-mail"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "mcp-mail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@annseraf/mcp-mail"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: ACCOUNTS_FILE (Path to accounts.json (default ~/.config/mcp-mail/accounts.json)), STDIO_PRESET (read-only | read-draft | organize | full-no-delete | full).

Alternatives to mcp-mail

same job, measured the same way
Oryah Mail
by infinihash

Governed email for agents: Gmail, M365 and IMAP; per-mailbox permissions, send allowlist, audit log

answering
ssh-mcp
by gelse

MCP gateway for controlled SSH access with per-client auth, command policies, and audit logging.

local only
Cortex RMCP
by dinglebear

Self-hosted homelab log intelligence over MCP, CLI, and REST with SQLite/FTS.

128 installs/wk local only
mcp-gatehouse
by nickgeorgeseo

Permission tiers, approval gates, and audit logging for MCP servers - the server is the gatekeeper

627 installs/wk local only
Cordon for MCP
by marras0914

Cordon for MCP. Security gateway with policy enforcement, audit log, and HITL approvals.

63 installs/wk local only
Auditreach
by rudrendupaul

BYOK Reddit/YouTube research CLI with a tamper-evident audit log and an MCP server.

149 installs/wk local only
Toolstile
by toolstile

Managed MCP gateway with OAuth, per-agent permissions, shared accounts and activity logs.

answering
Toolstile
by akshitkrnagpal

Managed MCP gateway with OAuth, per-agent permissions, shared accounts and activity logs.

answering

mcp-mail — questions

Answers built from our own checks of this server.

Why is there no uptime for mcp-mail?
mcp-mail runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @annseraf/mcp-mail was installed 577 times last week.
How do I connect mcp-mail?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls @annseraf/mcp-mail straight from npm; nothing to host, nothing to sign up for.
How many people use mcp-mail?
The npm package @annseraf/mcp-mail was installed 577 times in the last week. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is mcp-mail open source?
Yes — it is published under the MIT licence, written in TypeScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.