Email for AI agents — real inboxes in one call. Python + TypeScript SDKs and an MCP server that pulls signup codes straight out of inbound mail.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add dead-simple-email --env DSE_API_KEY='<DSE_API_KEY>' -- uvx deadsimple-email~/.codex/config.toml
[mcp_servers.dead-simple-email]
command = "uvx"
args = ["deadsimple-email"]
env = { DSE_API_KEY = "<DSE_API_KEY>" }
# codex mcp add dead-simple-email --env DSE_API_KEY='<DSE_API_KEY>' -- uvx deadsimple-email~/.cursor/mcp.json
{
"mcpServers": {
"dead-simple-email": {
"command": "uvx",
"args": [
"deadsimple-email"
],
"env": {
"DSE_API_KEY": "<DSE_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"dead-simple-email": {
"type": "stdio",
"command": "uvx",
"args": [
"deadsimple-email"
],
"env": {
"DSE_API_KEY": "<DSE_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"dead-simple-email": {
"command": "uvx",
"args": [
"deadsimple-email"
],
"env": {
"DSE_API_KEY": "<DSE_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"dead-simple-email": {
"command": "uvx",
"args": [
"deadsimple-email"
],
"env": {
"DSE_API_KEY": "<DSE_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"dead-simple-email": {
"command": "uvx",
"args": [
"deadsimple-email"
],
"env": {
"DSE_API_KEY": "<DSE_API_KEY>"
}
}
}
}Remote
claude mcp add --transport http dead-simple-email https://api.deadsimple.email/mcp --header 'Authorization: <AUTHORIZATION>'~/.codex/config.toml
[mcp_servers.dead-simple-email]
url = "https://api.deadsimple.email/mcp"
http_headers = { Authorization = "<AUTHORIZATION>" }
# codex mcp add dead-simple-email --url https://api.deadsimple.email/mcp~/.cursor/mcp.json
{
"mcpServers": {
"dead-simple-email": {
"url": "https://api.deadsimple.email/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"dead-simple-email": {
"type": "http",
"url": "https://api.deadsimple.email/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"dead-simple-email": {
"httpUrl": "https://api.deadsimple.email/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"dead-simple-email": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.deadsimple.email/mcp",
"--header",
"Authorization:<AUTHORIZATION>"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"dead-simple-email": {
"url": "https://api.deadsimple.email/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}Environment variables
DSE_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.