mailindex-mcp MCP Server

Name: mailindex-mcp MCP Server
Author: io.github.alexanderkrauck

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

Claude Desktop

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

{
  "mcpServers": {
    "mailindex-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/alexanderkrauck/mailindex-mcp:0.1.3"
      ],
      "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>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mailindex-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/alexanderkrauck/mailindex-mcp:0.1.3"
      ],
      "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>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mailindex-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/alexanderkrauck/mailindex-mcp:0.1.3"
      ],
      "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>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mailindex-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/alexanderkrauck/mailindex-mcp:0.1.3"
      ],
      "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>"
      }
    }
  }
}

Claude Code

claude mcp add mailindex-mcp --env EMAILSERVER_DATABASE_URL=<YOUR_EMAILSERVER_DATABASE_URL> --env EMAILSERVER_AUTH_MODE=<YOUR_EMAILSERVER_AUTH_MODE> --env EMAILSERVER_API_TOKEN=<YOUR_EMAILSERVER_API_TOKEN> --env CREDENTIAL_ENCRYPTION_KEY=<YOUR_CREDENTIAL_ENCRYPTION_KEY> -- docker run -i --rm ghcr.io/alexanderkrauck/mailindex-mcp:0.1.3