Skip to main content
Glama
Sign In
guerrillamail-mcp

guerrillamail-mcp

by cv3inx
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

guerrillamail-mcp

npm version npm downloads license Node

MCP server for the Guerrilla Mail temporary/disposable email API. Spin up throwaway inboxes, poll for mail, and read messages from any MCP client — Claude Desktop, Claude Code, Cursor, or any other.

Zero config. No API key. One command.

npx -y guerrillamail-mcp

Why

Need a throwaway email inside an AI workflow — signup testing, OTP capture, scratch inbox — without leaving the agent? This wires Guerrilla Mail's disposable inboxes straight into the Model Context Protocol so your agent can create an address, watch for mail, and read it, all on its own.

Related MCP server: protonmail-mcp-server

Install & usage

Run directly with npx — no install needed:

npx -y guerrillamail-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "guerrillamail": {
      "command": "npx",
      "args": ["-y", "guerrillamail-mcp"]
    }
  }
}

Claude Code CLI

claude mcp add guerrillamail -- npx -y guerrillamail-mcp

Tools

Tool

Description

Inputs

get_email_address

Get a new disposable address and start a session.

lang (optional, default "en")

set_email_user

Set the local part of the address for the session.

email_user (required)

check_inbox

Check the inbox; poll only newer mail with seq.

seq (optional, default "0")

fetch_email

Fetch the full body of one email (HTML stripped).

email_id (required)

delete_emails

Delete one or more emails.

email_ids (required, string[])

forget_me

Forget the session and clear local state.

none

Notes

  • Session state (sid_token + PHPSESSID cookie) is held in memory for the life of the process.

  • No API key required. Uses the public Guerrilla Mail AJAX endpoint.

License

MIT

Available Tools

6 tools
check_inboxA

Check the inbox. Pass seq to poll only emails newer than that id.

Inputs: seq.

delete_emailsB

Delete one or more emails by id.

Inputs: email_ids (required).

fetch_emailB

Fetch the full body of a single email by id.

Inputs: email_id (required).

forget_meA

Forget the current session and clear local session state.

Inputs: no named parameters.

get_email_addressB

Get a new disposable Guerrilla Mail address and start a session.

Inputs: lang.

set_email_userA

Set the local part of the email address for the current session.

Inputs: email_user (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.9/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a distinct purpose: checking inbox, deleting emails, fetching full emails, clearing session, getting an address, and setting user. No overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., check_inbox, delete_emails, fetch_email). No mixing of styles.

    Tool Count5/5

    6 tools is well-scoped for a disposable email service. It covers core operations without being too few or too many.

    Completeness5/5

    The set covers the full lifecycle: address acquisition, inbox polling, email retrieval, deletion, and session management. No critical gaps for the domain.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    Related MCP Servers

    • useblip/email

      blipemail
      A
      license
      A
      quality
      B
      maintenance
      MCP server for disposable email — create inboxes, receive emails, and extract OTP codes. Let your AI agent sign up for services, wait for verification emails, and extract codes autonomously.
      7
      51 npm
      1
      MIT

    • mcp-email

      algonacci
      A
      license
      Not graded
      quality
      D
      maintenance
      A minimal MCP server for reading, searching, managing, and sending email over IMAP and SMTP.
      MIT

    • smails

      pexni
      A
      license
      Not graded
      quality
      B
      maintenance
      Disposable email for humans and AI agents. Enables AI agents to create mailboxes and receive verification emails through an MCP server.
      39
      MIT