MCP server that exposes Postara mailboxes to Claude Desktop, Cursor, and Cline
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"postara-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# postara-mcp An [MCP](https://modelcontextprotocol.io) server that exposes [Postara](https://postara.dev) mailboxes to MCP clients like Claude Desktop, Cursor, and Cline. It is a thin client: it holds a base URL and an API key and calls a running Postara instance over HTTP. The same command works against a self-hosted deployment or the hosted service. Its only dependencies are `httpx` and `mcp`. ## Install ```bash pip install 'git+https://github.com/jmluang/postara-mcp.git' ``` Or run it without installing, using [uv](https://docs.astral.sh/uv/): ```bash uvx --from 'git+https://github.com/jmluang/postara-mcp.git' postara-mcp ``` ## Configure The server reads two environment variables: | Variable | Required | Default | Notes | |---|---|---|---| | `POSTARA_API_KEY` | yes | — | A scoped API key created in the Postara app. | | `POSTARA_BASE_URL` | no | `http://127.0.0.1:18080` | URL of the running Postara instance. | Create the API key in Postara (Workspace -> API keys). Give it only the scopes the client needs: - `read` — discover mailboxes, list folders and messages, fetch messages. - `mark_seen` — change read/unread state. Add this only if the client should mark messages seen. One `postara-mcp` process uses one API key, so it sees exactly the mailboxes that key can access. ## Connect Claude Desktop Add the server to `claude_desktop_config.json`: ```json { "mcpServers": { "postara": { "command": "uvx", "args": ["--from", "git+https://github.com/jmluang/postara-mcp.git", "postara-mcp"], "env": { "POSTARA_BASE_URL": "http://127.0.0.1:18080", "POSTARA_API_KEY": "pst_live_your_key_here" } } } } ``` If you installed the package with `pip`, set `"command": "postara-mcp"` and drop `args` instead. Restart Claude Desktop; the Postara tools then appear. Cursor and Cline use the same MCP server config shape. ## Tools | Tool | Purpose | |---|---| | `list_mailboxes` | Discover mailboxes the key can access. …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.