MCP Server

Quick Start

Install the Dead Simple Email package with MCP support:

              
              terminal
            
pip install deadsimple[mcp]

Claude Desktop

Add the following to your Claude Desktop configuration file. On macOS this is ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows it is %APPDATA%\Claude\claude_desktop_config.json.

              
              
              
              claude_desktop_config.json
            

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

Restart Claude Desktop and the email tools will appear in the tools menu. You can now ask Claude to create inboxes, send emails, read messages, and more using natural language.

Cursor

Add the same configuration to your Cursor MCP settings. Open Settings → MCP and add a new server, or edit .cursor/mcp.json in your project root:

              
              
              
              .cursor/mcp.json
            

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

Windsurf

In Windsurf, open Settings → Cascade → MCP and add the server. The configuration file is typically at ~/.windsurf/mcp.json:

              
              
              
              ~/.windsurf/mcp.json
            

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

Available Tools

The MCP server exposes 11 tools that cover the full Dead Simple Email API. Your AI assistant can call any of these tools when you ask it to work with email.

Tool	Description
`create_inbox`	Create a new email inbox with optional name and tags
`list_inboxes`	List all inboxes in your account
`delete_inbox`	Delete an inbox and all its messages
`send_email`	Send an email with to/cc/bcc support
`read_messages`	Read recent messages in an inbox
`read_message`	Read a single message with full body
`reply_to_message`	Reply to a message (threading automatic)
`forward_message`	Forward a message to new recipients
`list_threads`	List conversation threads in an inbox
`read_thread`	Read all messages in a thread
`get_usage`	Check account usage and plan limits

Full Example

Once the MCP server is configured, you can interact with email through natural language. Here is an example conversation with Claude Desktop:

              
              
              
              Claude Desktop conversation
            

# You:
Create a new inbox called "onboarding" and send a welcome email
to new-user@example.com from it.

# Claude uses create_inbox tool:
#   name: "onboarding"
#   → Created inbox: onboarding@yourco.deadsimple.email (inb_a1b2c3)

# Claude uses send_email tool:
#   inbox_id: "inb_a1b2c3"
#   to: "new-user@example.com"
#   subject: "Welcome aboard!"
#   body: "Hi there! Welcome to our platform. We're excited to..."
#   → Message sent: msg_x9y8z7

# Claude responds:
Done! I created the "onboarding" inbox at
onboarding@yourco.deadsimple.email and sent a welcome email
to new-user@example.com. The message was delivered successfully.
            

You can chain multiple operations naturally. Ask Claude to "check my support inbox for unread messages and reply to any that mention billing" and it will use read_messages, read_message, and reply_to_message in sequence.

Running the MCP Server Directly

You can also run the MCP server standalone for debugging or use with other MCP clients:

              
              terminal
            
# Set your API key
export DSE_API_KEY="dse_your_api_key"

# Start the MCP server on stdio
python -m deadsimple.integrations.mcp

The server communicates over stdio using the MCP protocol, so it works with any client that supports the standard.