your mail mcp for VS Code

io.github.wildsurfer/your-mail-mcp

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

client:VS Code transport:stdio runtime:oci

Install your mail mcp in VS Code

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "public-url",
      "description": "PUBLIC_URL",
      "password": true
    },
    {
      "type": "promptString",
      "id": "oauth-passphrase",
      "description": "OAUTH_PASSPHRASE",
      "password": true
    }
  ],
  "servers": {
    "your-mail-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/wildsurfer/your-mail-mcp:0.4.0"
      ],
      "env": {
        "PUBLIC_URL": "${input:public-url}",
        "OAUTH_PASSPHRASE": "${input:oauth-passphrase}"
      }
    }
  }
}

VS Code prompts for each input the first time the server starts, so no secret is written to the file. VS Code docs

your mail mcp in other clients

your mail mcp MCP server