# Cooper Email

Gives an agent its own cooperemail.com address: send, receive, search, and owner-approved drafts over email.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: cooper-email
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cooper-email/cooper-email
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/cooper-email

## What it does

Cooper Email hands an agent a mailbox like `your-agent@cooperemail.com`. A single API call sets up the account, the inbox and a key, so there is no dashboard step. From there the agent sends and reads mail: plain text, HTML, attachments, threads, search. Retries stay safe through the `client_id` idempotency key.

The repository holds the open-source client side: TypeScript and Python SDKs, packages for LangChain, the Vercel AI SDK, Mastra, Anthropic and OpenAI Agents, plus skills and MCP client configs. The hosted server runs at `https://cooperemail.com/mcp` over Streamable HTTP. First use signs you in with OAuth, so a key in the config is optional.

A human can stay in the loop. The owner confirms each send by email, and their replies arrive as tasks carrying SPF, DKIM and DMARC results plus a `verified_owner` flag. Webhooks for `message.received`, `message.sent`, `task.received` and `owner.reply` are signed with HMAC-SHA256 in the `x-cooper-signature` header. The `cooper-email` npm package is not published yet, so setup goes through the hosted server and the skills in this repo.

## Requirements
- Remote server: `https://cooperemail.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http cooper-email https://cooperemail.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add cooper-email --url https://cooperemail.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cooper-email": {
            "url": "https://cooperemail.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cooper-email": {
            "type": "http",
            "url": "https://cooperemail.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http cooper-email https://cooperemail.com/mcp
```

## When to use it
- give an agent a mailbox without manual setup
- read incoming mail and find messages by search
- hold a draft until the owner approves the send
- get a signed webhook when new mail lands
- reply to the owner in-thread and pull the answer back as a task

## Example prompts
- Create an inbox for the agent and send a welcome email to `team@example.com`
- Search the inbox for unread mail from today and sort it by topic
- Email the owner a draft reply and wait for approval before sending

## Similar
- [email-imap-fetch](https://affpapa.org/en/nevibecode/skills/email-imap-fetch.md) — skill · 371 installs
- [e2a — email for AI agents](https://affpapa.org/en/nevibecode/mcp/e2a-email-for-ai-agents.md) — MCP server · ★ 194
- [Email Inbox API + Sending by Sendmux](https://affpapa.org/en/nevibecode/mcp/email-inbox-api-sending-by-sendmux.md) — MCP server · ★ 62
- [pipefy-members-email-webhooks](https://affpapa.org/en/nevibecode/skills/pipefy-members-email-webhooks.md) — skill · 669 installs
- [agent-email-inbox](https://affpapa.org/en/nevibecode/skills/agent-email-inbox.md) — skill · 13400 installs
- [agent-email-patterns](https://affpapa.org/en/nevibecode/skills/agent-email-patterns.md) — skill · 853 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md