Email inboxes for AI agents. Give an agent its own address on cooperemail.com, let it send and receive real email over a simple HTTP API, get signed webhooks when mail arrives, and loop a human in by email when the agent needs a decision.
This repository holds the open-source client side of Cooper Email: the TypeScript and Python SDKs, framework tool packages, MCP client config, and examples. The hosted service itself is not in this repo.
What you get
Inboxes for agents. One API call creates an account, an inbox ([email protected]), and an API key. No dashboard needed.
Send and receive. Text, HTML, attachments, threads, search, and idempotent sends via client_id.
Human-in-the-loop tasks. Add an owner (they confirm by email), send progress / needs_input / done / error updates, and receive their replies as tasks you can long-poll and answer in-thread. Replies carry SPF/DKIM/DMARC results and a verified_owner flag.
Webhooks.message.received, message.sent, task.received, and owner.reply, signed with HMAC-SHA256 (x-cooper-signature: sha256=<hex>), optionally filtered to one inbox.
Hosted MCP server.https://cooperemail.com/mcp works with Claude, ChatGPT, Cursor, and other MCP clients.
This repository is also a Cursor plugin (.cursor-plugin/plugin.json). It registers the hosted MCP server https://cooperemail.com/mcp (OAuth sign-in on first use; no key in the config) and adds these skills from skills/:
Owner-approved drafts: a human approves each send by email
cooper-agent-signup-otp
Sign up as the agent and read the emailed verification code
cooper-owner-updates
Progress emails and daily digests to an owner; replies become tasks
cooper-custom-domains
Inboxes on your own domain (Starter and Pro)
cooper-mcp
MCP setup and troubleshooting for Cursor and other clients
cooper-agent-email-patterns
Architecture patterns and threat model for agent email
cooper-webhooks
One-call push webhooks, signature checks, test and re-enable
cooper-suppressions-bounces
Bounces, complaints, the suppression list, and rates
cooper-idempotent-sends
Retry-safe sends and creates with idempotency keys
cooper-sms
SMS status (coming soon) and the email alternatives today
To try it locally before it is listed, copy this repository into ~/.cursor/plugins/local/cooper-email and run Developer: Reload Window. To use an API key instead of OAuth, see skills/cooper-mcp.
Connect an agent
The cooper-email npm package is not published yet. Connect the hosted MCP server and install the skills from this repository.
Replace cooper-email with any other name from that table (cooper-check-email, cooper-send-email, cooper-mcp, and the rest). The skill is written to ~/.agents/skills/<name>/ and, for Claude Code, ~/.claude/skills/<name>/.
import os
from cooper_email import Cooper
with Cooper(api_key=os.environ["COOPER_API_KEY"]) as cooper:
inbox = cooper.inboxes.create("research-bot", display_name="Research")
cooper.messages.send(
inbox["id"],
to=["[email protected]"],
subject="Hello from my agent",
text="Does Tuesday work?",
client_id="hello-1",
)
messages = cooper.messages.list(inbox["id"], limit=20)
results = cooper.search("tuesday")
# Human in the loop
cooper.owners.add(inbox["id"], "[email protected]")
cooper.updates.notify(inbox["id"], "needs_input", "Which vendor should I book?")
tasks = cooper.tasks.list(inbox_id=inbox["id"], wait=25)["data"]
for task in tasks:
if task["verified_owner"] and task["trusted"]:
cooper.tasks.reply(task["id"], "Booked.", status="done")
Endpoint: https://cooperemail.com/mcp (Streamable HTTP). Claude and ChatGPT connectors sign in with OAuth. Cursor, Claude Code, and scripts can send Authorization: Bearer coop_live_…. The cooper_onboard tool works before you have a key.
Claude (claude.ai / Claude Desktop): Settings → Connectors → Add custom connector. Name Cooper Email, URL https://cooperemail.com/mcp, then approve Cooper on the OAuth screen. Then ask: "Create a Cooper Email inbox for research-bot."
Claude Code:
claude mcp add --transport http cooper-email https://cooperemail.com/mcp
Or install the Claude Code plugin (MCP server plus email and human-in-the-loop skills) from this repo:
ChatGPT: add a custom connector (in Settings → Apps & Connectors; some plans need Developer mode turned on first) with MCP server URL https://cooperemail.com/mcp and OAuth authentication, then approve Cooper on the consent screen. Menu names vary by plan.
Config for Windsurf, VS Code, Codex CLI, and Goose, plus the tool list, is in mcp/. The MCP Registry manifest is server.json. Cline install steps: llms-install.md.