Dead Simple Email — Claude Code MCP server for agent email
Give an agent tools to create inboxes, send and read messages, and extract verification codes. Useful for email-based sign-ups and workflows that depend on incoming mail.
claude mcp add dead-simple-email -e DSE_API_KEY=<DSE_API_KEY> -- uvx deadsimple-emailWhat Dead Simple Email does
Dead Simple Email exposes 14 tools for mailbox and message operations. An agent can create an inbox, send or reply to mail, read threads, and wait for new messages. One tool pulls an OTP or sign-in link from the latest email, so the agent can use it without parsing the message body itself.
Claude Code can connect to the hosted server over HTTP or run the Python MCP server locally over stdio. Both routes need an API key for email access. Without a valid key, the agent cannot use the mail API.
The repository also includes Python and TypeScript SDKs. For local MCP use, the key goes in DSE_API_KEY, and the server can be launched with uvx deadsimple-email.
What it helps with
- provision an inbox for an agent
- send mail from an agent-managed inbox
- read incoming messages and reply to a thread
- pull a verification code or sign-in link from email
- wait for an email during account registration
Example prompts for the agent
- Create a separate inbox for this test agent.
- Check the newest message and retrieve its verification code.
- Send a message with the subject “Done” and reply to the latest email.
How to install Dead Simple Email
1Platform CLI
claude mcp add dead-simple-email -e DSE_API_KEY=<DSE_API_KEY> -- uvx deadsimple-emailReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from deadsimple-email <command>
2Platform CLI: remote server
claude mcp add --transport http dead-simple-email https://api.deadsimple.email/mcp1Platform CLI: remote server
codex mcp add dead-simple-email --url https://api.deadsimple.email/mcp2Platform CLI
codex mcp add dead-simple-email --env DSE_API_KEY=<DSE_API_KEY> -- uvx deadsimple-emailReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from deadsimple-email <command>
Config file
{
"mcpServers": {
"dead-simple-email": {
"url": "https://api.deadsimple.email/mcp"
}
}
}{
"mcpServers": {
"dead-simple-email": {
"command": "uvx",
"args": [
"deadsimple-email"
],
"env": {
"DSE_API_KEY": "<DSE_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from deadsimple-email <command>
Config file
{
"servers": {
"dead-simple-email": {
"type": "http",
"url": "https://api.deadsimple.email/mcp"
}
}
}{
"servers": {
"dead-simple-email": {
"type": "stdio",
"command": "uvx",
"args": [
"deadsimple-email"
],
"env": {
"DSE_API_KEY": "<DSE_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from deadsimple-email <command>
1Platform CLI: remote server
gemini mcp add -t http dead-simple-email https://api.deadsimple.email/mcp2Platform CLI
gemini mcp add -e DSE_API_KEY=<DSE_API_KEY> dead-simple-email uvx deadsimple-emailReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from deadsimple-email <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Dead Simple Email
How do I install Dead Simple Email in Claude Code?
Connect the hosted server with claude mcp add --transport http dead-simple-email https://api.deadsimple.email/mcp. An API key is needed to access email functions.
What does Dead Simple Email do?
It gives agents tools to manage inboxes and email, including sending, reading, and replying. A dedicated tool extracts a verification code or sign-in link from a recent message.
Does the MCP server need an API key?
Yes. Local setup passes the key through DSE_API_KEY; the hosted server also requires a key for authorization.
