pypi deadsimple-emailstreamable-httpMITupdated 11d ago
Email infrastructure for AI agents. One call gives an agent a real, deliverable inbox โ no SMTP credentials, no DNS, no dashboard.
What can you do with Dead Simple Email?
Dead Simple Email
Email infrastructure for AI agents. One call gives an agent a real, deliverable inbox โ no SMTP credentials, no DNS, no dashboard.
deadsimple.email ยท Docs ยท API reference
Sign up with no human in the loop
An agent can provision its own account, API key and live inbox in a single unauthenticated call:
curl -X POST https://api.deadsimple.email/v1/auth/agent-signup
That returns a trial account (1 inbox, 10 sends/hour, 25/day). Claim it later with a verified email to move to the Free plan, keeping the same key and inboxes.
MCP server
Listed in the official MCP Registry
as email.deadsimple/dead-simple-email, and on
Smithery and
Glama.
Remote (recommended) โ nothing to install:
{
"mcpServers": {
"dead-simple-email": {
"type": "http",
"url": "https://api.deadsimple.email/mcp",
"headers": { "Authorization": "Bearer dse_your_api_key" }
}
}
}
Local (stdio):
{
"mcpServers": {
"deadsimple": {
"command": "python",
"args": ["-m", "deadsimple.mcp"],
"env": { "DSE_API_KEY": "dse_your_api_key" }
}
}
}
14 tools: create_inbox, list_inboxes, delete_inbox, send_email,
read_messages, read_message, reply_to_message, forward_message,
wait_for_email, get_verification_code, get_verification_link,
list_threads, read_thread, get_usage.
The one agents reach for most is get_verification_code โ it pulls the OTP
or magic link out of the newest inbound message, so an agent can sign itself up
for a third-party service or clear a 2FA prompt without ever parsing an email
body.
SDKs
| Language | Package | Source |
|---|---|---|
| Python | deadsimple-email |
python/ |
| TypeScript | deadsimple-email |
node/ |
pip install deadsimple-email
npm install @deadsimple/email
from deadsimple import DeadSimple
dse = DeadSimple("dse_your_api_key")
inbox = dse.inboxes.create(display_name="Support Bot")
dse.messages.send(inbox.inbox_id, to=["someone@example.com"],
subject="Hello", text_body="Sent by an agent.")
Framework integrations for LangChain, CrewAI, LlamaIndex, AutoGen and OpenAI
Agents live in python/src/deadsimple/integrations/.
Repository layout
| Path | What |
|---|---|
python/ |
Python SDK + MCP server |
node/ |
TypeScript SDK |
skills/ |
Agent skill files for Claude Code, Cursor, Windsurf |
mcp/ |
server.json manifest for the official MCP Registry |
License
MIT
Install
Add Dead Simple Email to your client. Pick the one you use.
{
"servers": {
"deadsimple-email": {
"type": "http",
"url": "https://api.deadsimple.email/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
claude mcp add deadsimple-email -- uvx deadsimple-emailcodex mcp add deadsimple-email -- uvx deadsimple-emailamp mcp add deadsimple-email -- uvx deadsimple-email{
"mcpServers": {
"deadsimple-email": {
"command": "uvx",
"args": [
"deadsimple-email"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"deadsimple-email": {
"command": "uvx",
"args": [
"deadsimple-email"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"mcpServers": {
"deadsimple-email": {
"command": "uvx",
"args": [
"deadsimple-email"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"deadsimple-email": {
"command": "uvx",
"args": [
"deadsimple-email"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"deadsimple-email": {
"command": "uvx",
"args": [
"deadsimple-email"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"deadsimple-email": {
"type": "local",
"command": "uvx",
"args": [
"deadsimple-email"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"deadsimple-email": {
"command": {
"path": "uvx",
"args": [
"deadsimple-email"
]
}
}
}
}Add to your Zed `settings.json`.
uvx deadsimple-emailRun `goose configure`, choose **Add Extension โ Command-line Extension**, and paste this command.
Score
39 / 100
Incomplete
- Documentation22/25
- Maintenance25/25
- Trust16/20
- Capability0/15
- Install experience15/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 4 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 18 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint โ no local install
Version history
| Versions | Published |
|---|---|
| 0.2.4Latest | Jul 30, 2026 |
| 0.2.3 | Jul 30, 2026 |
| 0.2.2 | Jul 27, 2026 |
| 0.2.1 | Jul 27, 2026 |