Spare.Email

Temp Mail MCP Server

Give AI assistants like Claude and Cursor read-only access to a Spare.Email mailbox — the official spare-email-mcp server.

What this is

MCP (Model Context Protocol) is the open standard that lets AI assistants call external tools. spare-email-mcp is the official MCP server for Spare.Email: point your assistant at your mailbox and it can list mail, read messages — including attachment metadata — and wait for incoming verification codes, extracting them automatically in dozens of languages.

The server exposes four tools: mailbox_info (which address you are connected to), list_mails (paginated inbox), read_mail (a full parsed message), and wait_for_otp (polls until a code arrives, with your own timeout). It runs locally on your machine via npx and talks to the same API the web app uses.

Read-only by design

The server cannot create mailboxes, send mail or delete anything — there is no such tool, and it uses only the documented read-only API: GET /api/settings, GET /api/parsed_mails and GET /api/parsed_mail/:id. It holds exactly one secret, the mailbox credential you give it, and persists nothing server-side. Give a temporary mailbox to an agent and its blast radius is that mailbox only; your personal inbox is never involved.

No MCP client required: any language that can send an Authorization header can call the same three endpoints directly. The MCP server on npm is a ready-made reference implementation of that contract, including OTP polling.

How to install it

Unauthenticated install for Claude Code, always the latest version:

Or add this block to the MCP configuration of Claude Desktop, Cursor or any other MCP client:

claude mcp add spare-email-mcp -e SPARE_EMAIL_JWT=YOUR_JWT -- npx -y spare-email-mcp
{
  "mcpServers": {
    "spare-email-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "spare-email-mcp"
      ],
      "env": {
        "SPARE_EMAIL_JWT": "YOUR_JWT"
      }
    }
  }
}

How to get the mailbox credential

Open spare.email and let a mailbox generate, or load an existing one. Open the Settings panel in the mailbox view and copy the Address JWT (mailbox access credential) — that string is YOUR_JWT in the snippets above. Anyone holding it can read that mailbox and nothing else, which is why the server asks you to supply it yourself instead of using accounts or cookies.

Prefer a clean setup? Create a fresh mailbox just for agent use, optionally with the Expiry button preset, so the credential dies together with the mailbox.

Self-hosted deployments

The server works against any cloudflare_temp_email deployment, not just spare.email — set SPARE_EMAIL_BASE_URL to your instance and, if your deployment enforces a global access password, add SPARE_EMAIL_SITE_PASSWORD. All three environment variables are optional except the JWT.

Where to get it

The package, source code, changelog and issue tracker are all public. Bugs and feature requests are welcome on GitHub.

spare-email-mcp on npmSource and README on GitHubOfficial MCP Registry entryRead-only mail API documentation

Read next:

What is a disposable email address?

Receive-only email: why we do not send

10 minute mail: a self-destructing inbox

FAQ

Back to mailbox
The service is temporarily unavailable, please try again shortly