# Dead Simple Email MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/email-deadsimple-dead-simple-email
- Repository: https://github.com/deadsimple-email/deadsimple-email
- Website: https://deadsimple.email

## Install
- Command: `uvx deadsimple-email`
- Endpoint: https://api.deadsimple.email/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: Authorization (required; secret)
- Package: Pypi deadsimple-email v0.2.2
- Environment variable: DSE_API_KEY (required; secret)
- Package: Oci ghcr.io/deadsimple-email/deadsimple-email:0.2.2
- Environment variable: DSE_API_KEY (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://api.deadsimple.email/mcp
- Header: Authorization

## Tools
- create_inbox (Create Inbox) - Create a new email inbox. Returns the inbox details including the email address.

    Args:
        display_name: Friendly name for the inbox (e.g. "Support Bot")
        tags: Comma-separated tags (e.g. "support,production")
     Endpoint: https://api.deadsimple.email/mcp
- list_inboxes (List Inboxes) - List all email inboxes in the account.

    Args:
        limit: Maximum number of inboxes to return (default 20)
     Endpoint: https://api.deadsimple.email/mcp
- delete_inbox (Delete Inbox) - Delete an inbox and all its messages.

    Args:
        inbox_id: The inbox ID to delete
     Endpoint: https://api.deadsimple.email/mcp
- send_email (Send Email) - Send an email from an inbox.

    Args:
        inbox_id: The inbox to send from
        to: Recipient email address (comma-separated for multiple)
        subject: Email subject line
        body: Email body (plain text)
        cc: CC recipients (comma-separated, optional)
        bcc: BCC recipients (comma-separated, optional)
     Endpoint: https://api.deadsimple.email/mcp
- read_messages (List Messages) - Read recent messages in an inbox.

    Args:
        inbox_id: The inbox to read from
        limit: Maximum number of messages to return (default 10)
     Endpoint: https://api.deadsimple.email/mcp
- read_message (Read Message) - Read a single message with full body content.

    Args:
        inbox_id: The inbox containing the message
        message_id: The message ID to read
     Endpoint: https://api.deadsimple.email/mcp
- reply_to_message (Reply to Message) - Reply to a message. Threading headers are set automatically.

    Args:
        inbox_id: The inbox containing the message
        message_id: The message ID to reply to
        body: Reply body (plain text)
     Endpoint: https://api.deadsimple.email/mcp
- forward_message (Forward Message) - Forward a message to new recipients.

    Args:
        inbox_id: The inbox containing the message
        message_id: The message ID to forward
        to: Recipient email address (comma-separated for multiple)
        body: Optional additional text to include
     Endpoint: https://api.deadsimple.email/mcp
- wait_for_email (Wait for Email) - Block until a NEW inbound email arrives in the inbox, then return it.

    Use for signup/verification flows: trigger the action that sends the email,
    then call this to receive it. Only emails arriving after this call count.

    Args:
        inbox_id: The inbox to watch
        from_contains: Only match senders containing this text (optional)
        subject_contains: Only match subjects containing this text (optional)
        timeout_seconds: Max seconds to wait (default 60)
     Endpoint: https://api.deadsimple.email/mcp
- get_verification_code (Get Verification Code) - Wait for a verification/OTP email and return the extracted code.

    Waits for the next new inbound email, then returns the auto-extracted
    verification code (and any magic link). Perfect for autonomous sign-ups.

    Args:
        inbox_id: The inbox to watch
        from_contains: Only match senders containing this text (optional)
        timeout_seconds: Max seconds to wait (default 60)
     Endpoint: https://api.deadsimple.email/mcp
- get_verification_link (Get Verification Link) - Wait for an email and return the extracted magic link / verification URL.

    Args:
        inbox_id: The inbox to watch
        from_contains: Only match senders containing this text (optional)
        timeout_seconds: Max seconds to wait (default 60)
     Endpoint: https://api.deadsimple.email/mcp
- list_threads (List Threads) - List conversation threads in an inbox.

    Args:
        inbox_id: The inbox to list threads for
        limit: Maximum number of threads to return (default 10)
     Endpoint: https://api.deadsimple.email/mcp
- read_thread (Read Thread) - Read all messages in a conversation thread.

    Args:
        inbox_id: The inbox containing the thread
        thread_id: The thread ID to read
     Endpoint: https://api.deadsimple.email/mcp
- get_usage (Get Usage) - Get account usage metrics: inboxes, emails sent/received, plan limits. Endpoint: https://api.deadsimple.email/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: email.deadsimple
- Version: 0.2.4
- Runtime: Pypi, Oci
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 30, 2026
- Source: https://registry.modelcontextprotocol.io