mailindex-mcp MCP Server

io.github.alexanderkrauck/mailindex-mcp

Repository Registry

What is the mailindex-mcp MCP server?

Search, move, mark, delete and draft your real mail over a self-hosted index.

How to install mailindex-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

EMAILSERVER_DATABASE_URL
required
PostgreSQL connection URL. This server keeps its own index and does not run without a database; the repository ships docker-compose files that start one for you.
EMAILSERVER_AUTH_MODE
How callers are authenticated: development (no auth, loopback only), single_user (static bearer token), or google (multi-user OAuth).
EMAILSERVER_API_TOKEN
secret
Bearer token required in single_user mode. At least 32 characters, or the server refuses to start.
CREDENTIAL_ENCRYPTION_KEY
secret
Key used to encrypt stored mailbox credentials at rest. Generate with: openssl rand -base64 32

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mailindex-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/alexanderkrauck/mailindex-mcp:0.2.1"
      ],
      "env": {
        "EMAILSERVER_DATABASE_URL": "<YOUR_EMAILSERVER_DATABASE_URL>",
        "EMAILSERVER_AUTH_MODE": "<YOUR_EMAILSERVER_AUTH_MODE>",
        "EMAILSERVER_API_TOKEN": "<YOUR_EMAILSERVER_API_TOKEN>",
        "CREDENTIAL_ENCRYPTION_KEY": "<YOUR_CREDENTIAL_ENCRYPTION_KEY>"
      }
    }
  }
}