Spare Email MCP

● Active

io.github.sparedotemail/spare-email-mcp

Read-only MCP server for spare.email mailboxes: list mail, read messages, wait for OTP codes.

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "spare-email-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "spare-email-mcp@0.1.2"
      ],
      "env": {
        "SPARE_EMAIL_JWT": "<your SPARE_EMAIL_JWT>",
        "SPARE_EMAIL_SITE_PASSWORD": "<your SPARE_EMAIL_SITE_PASSWORD>"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env SPARE_EMAIL_JWT='<your SPARE_EMAIL_JWT>' --env SPARE_EMAIL_SITE_PASSWORD='<your SPARE_EMAIL_SITE_PASSWORD>' --transport stdio spare-email-mcp -- npx -y spare-email-mcp@0.1.2
OpenAI Codex CLI
codex mcp add spare-email-mcp --env SPARE_EMAIL_JWT='<your SPARE_EMAIL_JWT>' --env SPARE_EMAIL_SITE_PASSWORD='<your SPARE_EMAIL_SITE_PASSWORD>' -- npx -y spare-email-mcp@0.1.2
VS Code
code --add-mcp '{"name":"spare-email-mcp","type":"stdio","command":"npx","args":["-y","spare-email-mcp@0.1.2"],"env":{"SPARE_EMAIL_JWT":"<your SPARE_EMAIL_JWT>","SPARE_EMAIL_SITE_PASSWORD":"<your SPARE_EMAIL_SITE_PASSWORD>"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • SPARE_EMAIL_JWTrequiredsecretAddress JWT of the spare.email (or self-hosted cloudflare_temp_email) mailbox to access
  • SPARE_EMAIL_SITE_PASSWORDsecretGlobal x-custom-auth access password, if the deployment enforces one

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Communication
Version
0.1.2
Registry
active
Published
11/16/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 18, 2026

Looks healthy: Spare Email MCP is maintained, open source.

Maintained
Active
Last commit 6 days ago (Nov 16, 2026), 0 open issues.
Official registry
Active
Published as io.github.sparedotemail/spare-email-mcp in the official MCP registry, version 0.1.2.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
On your machine
A local npm package started by your client; it can reach whatever your user account can.
Credentials
2 required
Declared environment variables: SPARE_EMAIL_JWT, SPARE_EMAIL_SITE_PASSWORD. They stay on your machine; the config on this page shows where each goes.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself.

On GitHub

read Nov 18, 2026
Stars
0
Forks
0
Last push
Nov 16, 2026
License
MIT

TypeScriptclaudecursordisposable-emailemailmcpmodel-context-protocolotptemp-mailverification-code

From the README

spare-email-mcp A read-only Model Context Protocol server for spare.email mailboxes (works with any cloudflaretempemail deployment). It lets MCP-aware agents (Claude, Cursor, Codex, ...) look inside a mailbox you already created: list the inbox, read a parsed mail, and wait for a verification code. It is deliberately read-only: it cannot create mailboxes, delete mail, or send anything, and it holds no credentials of its own — it uses the same Address JWT you can copy from the web UI. Tools Code extraction runs locally in the server using the multilingual rule-based extractor ported verbatim from the upstream worker (extract_code.ts, MIT) — keyword-anchored patterns in about a dozen languages, with guards against dates, amounts, phone numbers, and URLs. No AI model and no extra API calls. No mail arrives within the timeout? waitforotp returns a structured "nothing arrived" result instead of hanging or guessing. Configuration The server is configured entirely through environment variables: Every tool reports an actionable error on failure — for example, an expired JWT returns a hint to copy a fresh one from the web UI. Usage Claude Code Claude Desktop / Cursor / generic mcpServers block Security notes • The JWT grants full read access to that one mailbox only.…

Read the full README on GitHub →

The most-starred Communication servers in the index, with their live-check result.

ServerStarsLast pushLive check
Inbox Zero13,088Nov 2026Needs sign-in
Agent-Native Brain7,735Nov 2026Needs sign-in
Agent-Native Mail7,735Nov 2026Needs sign-in
Agent-Native Chat7,735Nov 2026Needs sign-in
Agent-Native Dispatch7,735Nov 2026Needs sign-in

Spare Email MCP: questions people ask

Is Spare Email MCP a remote or a local MCP server?
According to its entry in the official MCP registry, Spare Email MCP ships as a local package (npm) that your client starts on your machine.
Does Spare Email MCP need an API key?
Its registry entry declares 2 required environment variables: SPARE_EMAIL_JWT, SPARE_EMAIL_SITE_PASSWORD. The config on this page shows where each goes.
Is Spare Email MCP safe to use?
Looks healthy: Spare Email MCP is maintained, open source. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: On your machine; credentials: 2 required. Serverdex check of Nov 18, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is Spare Email MCP still maintained?
Active: the repository's last commit 6 days ago. Last push Nov 16, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 18, 2026.
How do I add Spare Email MCP to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Communication →

Add the badge to your site

Show visitors that Spare Email MCP is listed here — it’s also the link we check for a free listing.

Spare Email MCP — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-sparedotemail-spare-email-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Spare Email MCP — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Spare Email MCP — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-sparedotemail-spare-email-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/io-github-sparedotemail-spare-email-mcp) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/io-github-sparedotemail-spare-email-mcp) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/io-github-sparedotemail-spare-email-mcp)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/io-github-sparedotemail-spare-email-mcp"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-sparedotemail-spare-email-mcp"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-sparedotemail-spare-email-mcp"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).