Your Mail MCP Server

by wildsurferio.github.wildsurfer/your-mail-mcpv0.4.0

Read-only, self-hosted search over multiple IMAP accounts, mirrored by mbsync into a local notmuch index. Cannot send, delete or move mail.

17Dockerstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active4d ago

Install Your Mail MCP server

claude mcp add your-mail -- docker run -i --rm ghcr.io/wildsurfer/your-mail-mcp:0.4.0 stdio

{
  "mcpServers": {
    "your-mail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wildsurfer/your-mail-mcp:0.4.0",
        "stdio"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "your-mail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wildsurfer/your-mail-mcp:0.4.0",
        "stdio"
      ]
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "your-mail": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wildsurfer/your-mail-mcp:0.4.0",
        "stdio"
      ]
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "your-mail": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wildsurfer/your-mail-mcp:0.4.0",
        "stdio"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
PUBLIC_URL	—	—	Public base URL the server is reached at (used for OAuth metadata)
OAUTH_PASSPHRASE	—	yes	Passphrase gating the OAuth consent step

Freshness

Active — last maintenance signal 4d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-05 · 4d ago · GitHub
Latest release
2026-09-07 · 32d ago · GitHub · v0.4.0
Package published
no data · npm/PyPI
Registry entry updated
2026-09-07 · 32d ago · official registry · v0.4.0

FAQ

›How do I install the Your Mail MCP server in Claude Code?

Run: claude mcp add your-mail -- docker run -i --rm ghcr.io/wildsurfer/your-mail-mcp:0.4.0 stdio. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Your Mail require an API key?

Yes. It expects OAUTH_PASSPHRASE, of which 1 is a secret.

›Can I use Your Mail as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Your Mail in the official MCP registry?

Yes, as io.github.wildsurfer/your-mail-mcp.