English Français العربية

Dead Simple Email

Official registry Productivity

Give an agent its own inbox: send, receive, and pull signup codes from real email.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http dead-simple-email 'https://api.deadsimple.email/mcp' --header 'Authorization: <Bearer dse_your_api_key. Get one instantly with no signup form: POST https://api.deadsimple.email/v1/auth/agent-signup>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "dead-simple-email": {
            "type": "http",
            "url": "https://api.deadsimple.email/mcp",
            "headers": {
                "Authorization": "<Bearer dse_your_api_key. Get one instantly with no signup form: POST https://api.deadsimple.email/v1/auth/agent-signup>"
            }
        }
    }
}
PYPI package deadsimple-email
Claude Code 
claude mcp add dead-simple-email -e 'DSE_API_KEY=<your dse_api_key>' -- python deadsimple-email==0.11.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "dead-simple-email": {
            "command": "python",
            "args": [
                "deadsimple-email==0.11.0"
            ],
            "env": {
                "DSE_API_KEY": "<your dse_api_key>"
            }
        }
    }
}

Environment variables

  • DSE_API_KEY required secret Dead Simple Email API key (starts with dse_). Get one instantly with no signup form: POST https://api.deadsimple.email/v1/auth/agent-signup
OCI package ghcr.io/deadsimple-email/deadsimple-email:0.2.2
Claude Code 
claude mcp add dead-simple-email -e 'DSE_API_KEY=<your dse_api_key>' -- docker run -i --rm ghcr.io/deadsimple-email/deadsimple-email:0.2.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "dead-simple-email": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/deadsimple-email/deadsimple-email:0.2.2"
            ],
            "env": {
                "DSE_API_KEY": "<your dse_api_key>"
            }
        }
    }
}

Environment variables

  • DSE_API_KEY required secret Dead Simple Email API key (starts with dse_). Get one instantly with no signup form: POST https://api.deadsimple.email/v1/auth/agent-signup

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Dead Simple Email
  2. Sign up with no human in the loop
  3. MCP server
  4. SDKs
  5. Repository layout
  6. License

Dead Simple Email

Email infrastructure for AI agents. One call gives an agent a real, deliverable inbox — no SMTP credentials, no DNS, no dashboard.

deadsimple.email · Docs · API reference

Sign up with no human in the loop

An agent can provision its own account, API key and live inbox in a single unauthenticated call:

curl -X POST https://api.deadsimple.email/v1/auth/agent-signup

That returns a trial account (1 inbox, 10 sends/hour, 25/day). Claim it later with a verified email to move to the Free plan, keeping the same key and inboxes.

MCP server

Listed in the official MCP Registry as email.deadsimple/dead-simple-email, and on Smithery and Glama.

Remote (recommended) — nothing to install:

{
  "mcpServers": {
    "dead-simple-email": {
      "type": "http",
      "url": "https://api.deadsimple.email/mcp",
      "headers": { "Authorization": "Bearer dse_your_api_key" }
    }
  }
}

Local (stdio):

{
  "mcpServers": {
    "deadsimple": {
      "command": "python",
      "args": ["-m", "deadsimple.mcp"],
      "env": { "DSE_API_KEY": "dse_your_api_key" }
    }
  }
}

14 tools: create_inbox, list_inboxes, delete_inbox, send_email, read_messages, read_message, reply_to_message, forward_message, wait_for_email, get_verification_code, get_verification_link, list_threads, read_thread, get_usage.

The one agents reach for most is get_verification_code — it pulls the OTP or magic link out of the newest inbound message, so an agent can sign itself up for a third-party service or clear a 2FA prompt without ever parsing an email body.

SDKs

LanguagePackageSource
Pythondeadsimple-emailpython/
TypeScriptdeadsimple-emailnode/
pip install deadsimple-email
npm install @deadsimple/email
from deadsimple import DeadSimple

dse = DeadSimple("dse_your_api_key")
inbox = dse.inboxes.create(display_name="Support Bot")
dse.messages.send(inbox.inbox_id, to=["someone@example.com"],
                  subject="Hello", text_body="Sent by an agent.")

Framework integrations for LangChain, CrewAI, LlamaIndex, AutoGen and OpenAI Agents live in python/src/deadsimple/integrations/.

Repository layout

PathWhat
python/Python SDK + MCP server
node/TypeScript SDK
skills/Agent skill files for Claude Code, Cursor, Windsurf
mcp/server.json manifest for the official MCP Registry

License

MIT

Frequently asked questions

What is Dead Simple Email?

Give an agent its own inbox: send, receive, and pull signup codes from real email.

How do I install Dead Simple Email?

It runs as a remote server. In Claude Code: claude mcp add --transport http dead-simple-email 'https://api.deadsimple.email/mcp' --header 'Authorization: <Bearer dse_your_api_key. Get one instantly with no signup form: POST https://api.deadsimple.email/v1/auth/agent-signup>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Dead Simple Email need an API key?

Yes. It expects DSE_API_KEY, Authorization, which you set in its configuration.

Is Dead Simple Email open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Dead Simple Email?

It is published by deadsimple-email. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.