protogrid
Sign inAdd to your agent

Search / io.github.wildsurfer/your-mail-mcp

your-mail-mcp

L0· runs locally

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

v0.4.0 · active · repository · descriptor JSON · versions

Runs on your machine: something must execute the package.Only local packages are published (npm, PyPI, OCI, …). The registry never executes them, so tools are unknown until you run it.
Quality–not scored
Trust86of 100
Packages2
Tools seen0

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "your-mail-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OAUTH_PASSPHRASE",
        "ghcr.io/wildsurfer/your-mail-mcp:0.4.0"
      ],
      "env": {
        "OAUTH_PASSPHRASE": "${OAUTH_PASSPHRASE}"
      }
    }
  }
}
claude mcp add your-mail-mcp -e "OAUTH_PASSPHRASE=${OAUTH_PASSPHRASE}" -- docker run -i --rm -e OAUTH_PASSPHRASE ghcr.io/wildsurfer/your-mail-mcp:0.4.0
[mcp_servers.your-mail-mcp]
command = "docker"
args = ["run", "-i", "--rm", "-e", "OAUTH_PASSPHRASE", "ghcr.io/wildsurfer/your-mail-mcp:0.4.0"]
env = { "OAUTH_PASSPHRASE" = "${OAUTH_PASSPHRASE}" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "your-mail-mcp": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "-i",
        "--rm",
        "-e",
        "OAUTH_PASSPHRASE",
        "ghcr.io/wildsurfer/your-mail-mcp:0.4.0"
      ],
      "enabled": true,
      "environment": {
        "OAUTH_PASSPHRASE": "{env:OAUTH_PASSPHRASE}"
      }
    }
  }
}
{
  "mcpServers": {
    "your-mail-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OAUTH_PASSPHRASE",
        "ghcr.io/wildsurfer/your-mail-mcp:0.4.0"
      ],
      "env": {
        "OAUTH_PASSPHRASE": "${OAUTH_PASSPHRASE}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=your-mail-mcp&config=eyJjb21tYW5kIjoiZG9ja2VyIiwiYXJncyI6WyJydW4iLCItaSIsIi0tcm0iLCItZSIsIk9BVVRIX1BBU1NQSFJBU0UiLCJnaGNyLmlvL3dpbGRzdXJmZXIveW91ci1tYWlsLW1jcDowLjQuMCJdLCJlbnYiOnsiT0FVVEhfUEFTU1BIUkFTRSI6IiR7T0FVVEhfUEFTU1BIUkFTRX0ifX0%3D"
}
{
  "servers": {
    "your-mail-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OAUTH_PASSPHRASE",
        "ghcr.io/wildsurfer/your-mail-mcp:0.4.0"
      ],
      "env": {
        "OAUTH_PASSPHRASE": "${OAUTH_PASSPHRASE}"
      }
    }
  }
}
{
  "mcpServers": {
    "your-mail-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OAUTH_PASSPHRASE",
        "ghcr.io/wildsurfer/your-mail-mcp:0.4.0"
      ],
      "env": {
        "OAUTH_PASSPHRASE": "${OAUTH_PASSPHRASE}"
      }
    }
  }
}
extensions:
  "your-mail-mcp":
    enabled: true
    name: "your-mail-mcp"
    type: stdio
    cmd: "docker"
    args:
      - "run"
      - "-i"
      - "--rm"
      - "-e"
      - "OAUTH_PASSPHRASE"
      - "ghcr.io/wildsurfer/your-mail-mcp:0.4.0"
    envs:
      "OAUTH_PASSPHRASE": "${OAUTH_PASSPHRASE}"
    timeout: 300

Placeholders to fill from your own secret store: ${OAUTH_PASSPHRASE}. The registry never accepts secret values.

This is a local package: the command runs on your machine.

Quality – / 100not scored

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

protocoln/a · weight 25
  • n/a
    protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygienen/a · weight 30
  • n/a
    tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)
stabilityn/a · weight 15
  • n/a
    stability.changes, stability.rug_pulltool list unknown
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

Tool list unknown · checked 2026-10-19 10:52 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 86 / 100

provenance80
livenessn/a
freshness85
hygiene95

+repository +namespace-matches-repo ~liveness-unmeasured ~updated-42d-ago -unpinned-packages(2)

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

packageregistryversionruntimesecrets
ghcr.io/wildsurfer/your-mail-mcp:0.4.0ociunpinned–OAUTH_PASSPHRASE
ghcr.io/wildsurfer/your-mail-mcp:0.4.0ociunpinneddocker

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

  • MailboxL0
    io.github.psyb0t/mailbox

    Self-hosted MCP server for unified IMAP/SMTP mailbox access: read, list, and send email.

  • google-mail-mcpL0
    io.github.mmedum/google-mail-mcp

    Gmail over MCP from your own account: search, read threads and messages, labels and drafts.

  • mcp4mailR2quality 100
    online.mcp4mail/mcp4mail

    Your IMAP mailbox as an MCP server: read, search and (if you allow it) organize mail. Open source.

  • mail-indexL0
    io.github.unsoldgroup/mail-index

    Local-first, read-only MCP server for recall over your Gmail: search, contacts, threads, digests.

  • mailindex-mcpL0
    io.github.alexanderkrauck/mailindex-mcp

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

  • MCP EmailsR2quality 100
    com.mcpemails/emails

    Never-stored live email: read, send, organize, schedule and auto-triage Gmail or any IMAP mailbox.

More from io.github.wildsurfer

  • CNN Fear & Greed IndexL0
    io.github.wildsurfer/cnnfag

    CNN's Fear & Greed index for the US stock market: score, rating, indicators and daily history.

Official server.json
{
  "name": "io.github.wildsurfer/your-mail-mcp",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "0.4.0",
  "packages": [
    {
      "transport": {
        "url": "http://localhost:8080/mcp",
        "type": "streamable-http"
      },
      "identifier": "ghcr.io/wildsurfer/your-mail-mcp:0.4.0",
      "registryType": "oci",
      "environmentVariables": [
        {
          "name": "PUBLIC_URL",
          "format": "string",
          "description": "Public base URL the server is reached at (used for OAuth metadata)"
        },
        {
          "name": "OAUTH_PASSPHRASE",
          "format": "string",
          "isSecret": true,
          "description": "Passphrase gating the OAuth consent step"
        }
      ]
    },
    {
      "transport": {
        "type": "stdio"
      },
      "identifier": "ghcr.io/wildsurfer/your-mail-mcp:0.4.0",
      "runtimeHint": "docker",
      "registryType": "oci",
      "packageArguments": [
        {
          "type": "positional",
          "value": "stdio"
        }
      ],
      "runtimeArguments": [
        {
          "type": "positional",
          "value": "run"
        },
        {
          "type": "positional",
          "value": "-i"
        },
        {
          "type": "positional",
          "value": "--rm"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/wildsurfer/your-mail-mcp",
    "source": "github"
  },
  "description": "Read-only, self-hosted MCP access to IMAP email, mirrored locally and indexed by notmuch."
}