your-mail-mcp

local MCP server

Installation

Terminal

claude mcp add your-mail-mcp -e PUBLIC_URL=... -e OAUTH_PASSPHRASE=... -- docker run -i --rm ghcr.io/wildsurfer/your-mail-mcp:0.4.0

Run in your project folder. Add --scope user to use it everywhere.

Claude Desktop, Cursor & other clients

Add to claude_desktop_config.json or .cursor/mcp.json.

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

Fill in the environment variables with your own credentials.

Summary

Read-only, self-hosted MCP access to IMAP email, mirrored locally and indexed by notmuch.

Questions

your-mail-mcp is a local MCP server distributed as the oci package ghcr.io/wildsurfer/your-mail-mcp:0.4.0.

Run: claude mcp add your-mail-mcp -e PUBLIC_URL=... -e OAUTH_PASSPHRASE=... -- docker run -i --rm ghcr.io/wildsurfer/your-mail-mcp:0.4.0

Run: codex mcp add your-mail-mcp --env PUBLIC_URL=... --env OAUTH_PASSPHRASE=... -- docker run -i --rm ghcr.io/wildsurfer/your-mail-mcp:0.4.0

Similar MCP servers

NameStars

HQBaseio.github.HQBase/hqbase332
GeoLensio.github.geolens-io/geolens261
obsidian-sync-mcpio.github.es617/obsidian-sync-mcp56
thunderbird-cliio.github.vitalio-sh/thunderbird-cli50
MailFathomio.github.Krzysztof318/mailfathom13
Hint-Services-obsidian-github-mcpai.smithery/Hint-Services-obsidian-github-mcp9
mcp-server-browserio.github.bytedance/mcp-server-browser39K
mcp-server-filesystemio.github.bytedance/mcp-server-filesystem39K