Local MCP server for Postfleet — give an AI agent its own email address, then send, receive, and read mail. Runs on your machine over stdio and talks to the Postfleet API with your key.

Prefer a hosted server (no install)? Point your client at https://api.postfleet.ai/api/mcp with an Authorization: Bearer <key> header instead.

Setup

You need a Postfleet API key (pf_...) from https://postfleet.ai. No install step — npx fetches the latest on demand.

Claude Desktop / Cursor / any MCP client

{
  "mcpServers": {
    "postfleet": {
      "command": "npx",
      "args": ["-y", "@postfleet/mcp"],
      "env": { "POSTFLEET_API_KEY": "pf_your_key_here" }
    }
  }
}

Claude Code

claude mcp add postfleet --env POSTFLEET_API_KEY=pf_your_key_here -- npx -y @postfleet/mcp

Environment

Variable	Required	Default	Purpose
`POSTFLEET_API_KEY`	yes	—	Your `pf_` API key.
`POSTFLEET_API_URL`	no	`https://api.postfleet.ai`	API origin. Override for staging/self-hosted.

Tools

create_mailbox, send_email, reply_email, list_inbox, read_email, wait_for_email — a mailbox the agent owns, plus send/reply/read and a blocking wait-for-reply.