Your Mail MCP
Your mail already holds the answers: booking references, gate codes, invoices, warranty periods, promises people made in writing. This server lets your AI assistant find them, and it can only read.
People who work with email, gmail and icloud and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Go.
VERIFIED ACTIVE
LAST COMMIT 2026-09-07 · ★ 15 · #70 OF 90 MAINTAINED EMAIL · VERIFIED 2026-09-18
MIT · Go servers · how we verify → /methodology
01 · Install Your Mail MCP
before you install - you'll need
Set WORK_PASS, PERSONAL_PASS, PUBLIC_URL, OAUTH_PASSPHRASE before connecting.
Docker
docker run -i --rm ghcr.io/wildsurfer/your-mail-mcp:0.4.0 Claude Desktop - add to config
{
"mcpServers": {
"wildsurfer-your-mail-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/wildsurfer/your-mail-mcp:0.4.0"
]
}
}
} 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 container (OCI image) - can be sandboxed away from your filesystem
repo age created 2026-08-20 - young repo, little track record yet
license MIT - declared in the repository
registry namespace io.github.wildsurfer is GitHub-verified and matches the repo owner
03 · What Your Mail MCP can do
Prose above is summarized from the project's README and registry record - no invented capabilities.
Latest releases
v0.4.0 · 2026-09-07
What's new · The mirror can follow remote deletions. Set expunge_local: true on an · account and a message removed on the server is removed from the local · mirror on the next pass. Until now such a message stayed on…
v0.3.0 · 2026-08-28
What's new · One process, two attach points. The container runs serve: sync, · index, a Unix socket at /index/mcp.sock for local clients, and the HTTP · listener only when PUBLIC_URL is set. Local clients attach with…
v0.2.0 · 2026-08-26
What's new · status tool. Reports sync health per account: whether the first full · sync has completed, the last successful sync, messages indexed, consecutive · errors and any backoff. A model can now tell a filling…
04 · Who maintains Your Mail MCP
your-mail-mcp is maintained by wildsurfer. We track 2 MCP servers from wildsurfer - 2 actively maintained, 17 combined GitHub stars, oldest repo from Mar 2021. Full record: all servers from wildsurfer.
05 · Facts
- repository
- github.com/wildsurfer/your-mail-mcp
- category
- email - ranked #70 of 90 actively-maintained email servers as of 2026-09-18.
- release cadence
- 4 releases in the last 90 days (latest 2026-09-07)
- registry
- io.github.wildsurfer/your-mail-mcp (active, first published 2026-08-21 · 4 versions)
- packages
- oci:ghcr.io/wildsurfer/your-mail-mcp:0.4.0 · oci:ghcr.io/wildsurfer/your-mail-mcp:0.4.0
06 · Your Mail MCP FAQ
What is Your Mail MCP?
Your mail already holds the answers: booking references, gate codes, invoices, warranty periods, promises people made in writing. This server lets your AI assistant find them, and it can only read.
Is Your Mail MCP still maintained?
Yes - as of 2026-09-18, its last commit was 2026-09-07 and it shipped 4 releases in the last 90 days. We re-verify nightly.
How do I install Your Mail MCP?
Run `docker run -i --rm ghcr.io/wildsurfer/your-mail-mcp:0.4.0`. The README documents 4 environment variables (WORK_PASS, PERSONAL_PASS, PUBLIC_URL…) to set first. Set WORK_PASS, PERSONAL_PASS, PUBLIC_URL, OAUTH_PASSPHRASE before connecting. You can also paste the ready-made client config above.
07 · Alternatives to Your Mail MCP
Alternatives to Your Mail MCP
Maintained email servers if Your Mail MCP isn't the fit.
- Emailmd Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails. ★ 1,373 · 2026-08-26
- Sessy - Amazon SES observability Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats. ★ 929 · 2026-09-15
- Hqbase Connect AI agents to your self-hosted HQBase shared email workspace. ★ 326 · 2026-09-12
- SendGrid MCP server for SendGrid - global transactional + marketing email (Twilio-owned) ★ 271 · 2026-08-29
- Atomic Mail Programmable email inbox for AI agents - JMAP, PoW auth, stdio MCP server. ★ 267 · 2026-09-10
- Clippy Copy AI-generated content to the macOS clipboard: rich Gmail-ready email drafts, text, and files ★ 247 · 2026-09-04
More email MCP servers · Wraps · Proofpoint · Gmail Attachments MCP · Launch Engine - Business Execution OS · Palmyr
More Go MCP servers · Cloudcostsmcp · Agent Memory · Gopls MCP · Kdbx · A2ahub · see all