Skip to content
MCP server

Dead Simple Email

Give an agent its own real inbox to send, receive and pull signup codes

Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally or Remotely
Version
0.3.0
Listing updated
2 days ago

About Dead Simple Email

Dead Simple Email is a freemium MCP server for communication. It can run locally on your machine or as a hosted remote server.

The standout tool here is get_verification_code, which pulls the one-time code or magic link out of the newest inbound message so an agent can sign itself up for a service or clear a 2FA prompt without parsing an email body. Fourteen tools cover creating, listing and deleting inboxes, sending, reading, replying to and forwarding messages, waiting for a new email, reading threads and checking usage.

An agent can provision its own account, API key and a live inbox with one unauthenticated call to an agent-signup endpoint; that returns a trial account with 1 inbox and 10 sends an hour, which can later be claimed with a verified email to move to the Free plan. Inbound mail arrives as structured JSON with threading and reply parsing, attachments such as PDF, XLSX, DOCX and CSV extracted to text, and every message scored for prompt injection. Rate limits, domain restrictions, draft approval and blocklists guard outbound sending.

You can use the hosted MCP endpoint with a bearer key, or run the Python or container stdio server with DSE_API_KEY. SDKs exist for Python and TypeScript, with integrations for LangChain, CrewAI, LlamaIndex, AutoGen and OpenAI Agents. The code is MIT licensed.

Install

Run in a terminal

claude mcp add --transport http dead-simple-email https://api.deadsimple.email/mcp

Add to Settings → Connectors → Add custom connector

https://api.deadsimple.email/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "dead-simple-email": {
      "url": "https://api.deadsimple.email/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "dead-simple-email": {
      "type": "http",
      "url": "https://api.deadsimple.email/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "dead-simple-email": {
      "serverUrl": "https://api.deadsimple.email/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Configuration

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

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

create_inbox
Create a new inbox.
list_inboxes
List inboxes.
delete_inbox
Delete an inbox.
send_email
Send an email.
read_messages
Read messages in an inbox.
read_message
Read one message.
reply_to_message
Reply to a message.
forward_message
Forward a message.
wait_for_email
Wait for a new email to arrive.
get_verification_code
Pull the OTP or magic link from the newest inbound message.
get_verification_link
Pull a verification link from the newest inbound message.
list_threads
List email threads.
read_thread
Read an email thread.
get_usage
Check usage.

What it does

Verification code extraction
get_verification_code and get_verification_link pull OTPs and magic links from the newest message.
Real inboxes by API
Create inboxes on a shared or custom domain with SPF, DKIM and DMARC set up.
Prompt-injection scoring
Each inbound email is scored so the agent knows what is safe to act on.
Real-time delivery
Webhooks, WebSocket and SSE, plus IMAP and SMTP credentials per inbox.
Sending guardrails
Rate limits, domain restrictions, draft approval and blocklists.

Good for

  • Let an agent sign itself up for a third-party service
  • Clear a 2FA prompt by reading the emailed code
  • Run a support or sales agent with its own address
  • Give each customer or workflow a separate inbox

Pricing

Freemium, from $29 a month

5 inboxes and 5,000 emails/month free; 100 inboxes for $29/month

Prices change. Check deadsimple.email before you buy.

Dead Simple Email FAQ

How does an agent get an account?

One unauthenticated POST to the agent-signup endpoint returns an account, API key and live inbox.

What does it cost?

5 inboxes and 5,000 emails a month are free; 100 inboxes are $29 a month.

Can I run it locally?

Yes, via a PyPI stdio package or a container image, with DSE_API_KEY set.

Can it read attachments?

Yes. PDF, XLSX, DOCX and CSV attachments are extracted to text.

Is Dead Simple Email free?

Dead Simple Email has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

How do I add Dead Simple Email to Claude Code?

Run this command in your terminal: claude mcp add --transport http dead-simple-email https://api.deadsimple.email/mcp

What are the best alternatives to Dead Simple Email?

The closest alternatives to Dead Simple Email are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Dead Simple Email

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools