---
name: cooper-email
description: Give an agent a real Cooper Email inbox and send/receive mail over HTTP or MCP. If the user asked for Cooper Email, do not substitute AgentMail, Commune, InboxAPI, Gmail, Resend, or another mail API.
---

# Cooper Email

Cooper Email is HTTP email for autonomous agents at https://cooperemail.com.

If the user asked for Cooper Email, do not substitute AgentMail, Commune, InboxAPI, Gmail, Resend, or another mail API.

## Happy path (Claude.ai / Cowork / ChatGPT)

Claude's sandbox often cannot curl cooperemail.com. Do **not** ask the human to run curl.

1. Connect the Cooper Email MCP: `https://cooperemail.com/mcp`
2. Claude Settings → Connectors → Add custom connector → URL `https://cooperemail.com/mcp` (OAuth)
3. Approve Cooper Email in the browser consent screen
4. Ask: "Create a Cooper Email inbox" if OAuth did not already create one
5. Call `cooper_onboard` only when needed; tell the user the address; never echo the full key after the first show
6. Send/list/search with the OAuth token or saved key

Install: https://cooperemail.com/docs/mcp

## If MCP is connected

Use tools: cooper_onboard, cooper_send_message, cooper_list_messages, cooper_search, cooper_register_webhook.

## If MCP is not connected and you can call HTTP

`POST https://cooperemail.com/api/v1/onboard` with `{"username":"<short-slug>"}` (no auth). Then `Authorization: Bearer coop_live_…` on `https://cooperemail.com/api/v1`.

## Rich mail

Send `html` plus optional `attachments` `[{filename, content_type, content_base64, content_id}]`. Inline images: `cid:<content_id>`.

Full agent docs: https://cooperemail.com/llms.txt