{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_vdemmm35b47b","handle":"alpha-romer-coma-proton-bridge-mcp","url":"https://wellknown.network/agents/alpha-romer-coma-proton-bridge-mcp","links":{"self":"https://wellknown.network/agents/alpha-romer-coma-proton-bridge-mcp/record.json","html":"https://wellknown.network/agents/alpha-romer-coma-proton-bridge-mcp","markdown":"https://wellknown.network/agents/alpha-romer-coma-proton-bridge-mcp/record.md","api":"https://wellknown.network/api/v1/agents/alpha-romer-coma-proton-bridge-mcp","status":"https://wellknown.network/api/v1/agents/alpha-romer-coma-proton-bridge-mcp/status","claim":"https://wellknown.network/agents/alpha-romer-coma-proton-bridge-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/alpha-romer-coma-proton-bridge-mcp/claim.json","badge":"https://wellknown.network/agents/alpha-romer-coma-proton-bridge-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/alpha-romer-coma-proton-bridge-mcp/history","tools":"https://wellknown.network/api/v1/agents/alpha-romer-coma-proton-bridge-mcp/tools"},"ard":{"identifier":"urn:air::server:alpha-romer-coma-proton-bridge-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"proton-bridge-mcp","summary":"Thin Python wrapper (pip/uvx installable) for the proton-bridge-mcp MCP server, which reads/searches Proton Mail via Proton Mail Bridge. Requires Node.js; runs the real Node implementation via npx.","description":"# proton-bridge-mcp (Python wrapper)\n\nA `pip`/`uvx`-installable wrapper around [`proton-bridge-mcp`](https://github.com/alpharomercoma/proton-bridge-mcp), an [MCP](https://modelcontextprotocol.io) server for reading and searching Proton Mail via Proton Mail Bridge.\n\n**This package contains no Python implementation.** It's a thin shim that execs into the real Node.js implementation via `npx`. It exists so Python-oriented MCP tooling (`uvx`, `pipx`, `pip install`) can install and run it without needing to know it's Node underneath.\n\nUnofficial, community project. Not affiliated with or endorsed by Proton AG.\n\n## Requirements\n\n- **Node.js 18+** must be installed and on `PATH` (specifically `npx`). This wrapper cannot function without it — there is no pure-Python fallback.\n- A Proton Mail plan that supports Bridge, with [Proton Mail Bridge](https://proton.me/mail/bridge) running\n\n## Install\n\n```bash\npip install proton-bridge-mcp\n# or\nuvx proton-bridge-mcp\n```\n\n## Setup\n\nRun the interactive setup wizard once (fetches and pins Bridge's TLS certificate, verifies login, writes credentials to `~/.config/proton-bridge-mcp/`, chmod 600):\n\n```bash\nproton-bridge-mcp-setup\n```\n\n## Register with an MCP client\n\n**Claude Code:**\n\n```bash\nclaude mcp add proton-mail -s user -- proton-bridge-mcp\n```\n\n**Claude Desktop / other MCP clients:**\n\n```json\n{\n  \"mcpServers\": {\n    \"proton-mail\": {\n      \"command\": \"proton-bridge-mcp\"\n    }\n  }\n}\n```\n\n**Codex CLI:**\n\nTested end-to-end against Codex CLI 0.146.0 via `uvx`, with a real Bridge connection and real tool calls. MCP support is behind an under-development feature flag as of 0.146.0 — enable it once:\n\n```bash\ncodex features enable mcp_2026_07_28\n```\n\nThen register the server:\n\n```bash\ncodex mcp add proton-mail -- uvx proton-bridge-mcp\n```\n\n`uvx` resolves and caches per exact version, so (unlike a bare `npx` invocation of the underlying npm package) it isn't at risk of silently picking up a stale global install — no version pinning needed…","publisher":{"name":"Alpha Romer Coma","url":null},"homepage":"https://github.com/alpharomercoma/proton-bridge-mcp-py","repository":"https://github.com/alpharomercoma/proton-bridge-mcp-py","version":"1.0.1","license":null,"protocols":["mcp"],"tags":["claude","email","imap","mcp","model-context-protocol","proton-bridge","proton-mail"],"pricing":null,"endpoints":[{"url":"pypi:proton-bridge-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"productivity.email","name":"Email","confidence":1,"provenance":"declared"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.756,"provenance":"derived"}],"categories":["dev","productivity"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"proton-bridge-mcp","registry":"pypi","observedAt":"2026-11-10T00:24:47.920Z","publishedAt":"2026-08-05T04:59:45.741009Z","latestVersion":"1.0.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"proton-bridge-mcp","url":"https://pypi.org/project/proton-bridge-mcp/","firstSeenAt":"2026-09-10T10:24:09.666Z","fetchedAt":"2026-11-10T00:23:37.532Z","normalizedAt":"2026-11-10T00:23:37.532Z"}]},"firstSeenAt":"2026-09-10T10:24:09.666Z","updatedAt":"2026-11-10T00:24:47.920Z"}