# Email

> Email is an MCP server for communication. Email infrastructure for AI agents with sending, receiving, search and reply over MCP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API, CLI, Web
- **Website:** https://www.primitive.dev
- **Repository:** https://github.com/primitivedotdev/primitive-mono-repo
- **MCP Registry name:** dev.primitive/email
- **Categories:** [communication](https://ai-powered.com/categories/communication), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-15

## About

Primitive gives an agent its own email identity instead of access to a person's mailbox. Managed *.primitive.email addresses run a JavaScript handler on every inbound message, and a chat verb sends a message and returns the threaded reply in one round trip. Mail authentication (SPF, DKIM, DMARC, TLS-RPT), bounce handling and sending reputation are managed, with custom domains supported.

The hosted server uses Streamable HTTP with OAuth and lists seven tools: sendEmail, replyToEmail, listEmails, searchEmails, getEmail, getInboxStatus and getAccount. The same surface is available as a v1 REST API with OpenAPI 3.1, Node, Python and Go SDKs, a CLI and signed webhooks. Sends accept idempotency keys, and rate limits return 429 with a Retry-After header.

An agent can self-serve a credential by verifying an email address. Stored inbound mail is kept until you delete it. The site mentions three usage-based tiers but the prices are cut off.

## Features

- **Agent-owned addresses:** Managed subdomains that run a handler on each inbound message.
- **Threaded chat verb:** Send a message and get the reply in one call.
- **Managed deliverability:** Authentication records, bounces and IP reputation handled.
- **Idempotent sends:** Retries with an idempotency key never duplicate a message.
- **Self-serve auth:** Agents sign up by verifying an email and receive an OAuth token.
- **Multiple interfaces:** REST, SDKs, CLI and MCP share one surface.

## Good for

- Give an agent an email address to receive replies
- Send transactional mail from a custom domain
- Search an agent's inbox from an MCP client
- Spin up addresses for many short-lived agents

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http email https://www.primitive.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.primitive.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "email": {
      "url": "https://www.primitive.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "email": {
      "type": "http",
      "url": "https://www.primitive.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "email": {
      "serverUrl": "https://www.primitive.dev/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://www.primitive.dev/mcp
```

Enter a Name (for example "Email"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "email": {
      "type": "http",
      "url": "https://www.primitive.dev/mcp"
    }
  }
}
```

## Tools

- `sendEmail`: Send an email.
- `replyToEmail`: Reply to an email.
- `listEmails`: List emails.
- `searchEmails`: Search emails.
- `getEmail`: Read one email.
- `getInboxStatus`: Read inbox status.
- `getAccount`: Read account details.

## FAQ

### What tools does the MCP server expose?

Seven: sendEmail, replyToEmail, listEmails, searchEmails, getEmail, getInboxStatus and getAccount.

### How do agents authenticate?

With a prim_ API key or a prim_oat_ OAuth access token scoped to an organization.

### Does it keep received mail?

Yes, until you delete it; stored mail is not auto-deleted.

### Which clients work?

Claude, Cursor, VS Code with Copilot agent mode and Goose are named.

### How do I add Email to Claude Code?

Run this command in your terminal: claude mcp add --transport http email https://www.primitive.dev/mcp

### What are the best alternatives to Email?

The closest alternatives to Email are Agent Email List — Free SMTP Relay for AI Agents, MCP, Mails.ai — Agent Email, Spare Email MCP and Replyz.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Agent Email List — Free SMTP Relay for AI Agents](https://ai-powered.com/mcp/agent-email-list-free-smtp-relay-for-ai-agents): Agent Email List — Free SMTP Relay for AI Agents is a free MCP server for communication.
- [MCP](https://ai-powered.com/mcp/mcp-33): MCP is a freemium MCP server for communication.
- [Mails.ai — Agent Email](https://ai-powered.com/mcp/mails-ai-agent-email): Mails.ai — Agent Email is a freemium MCP server for communication.
- [Spare Email MCP](https://ai-powered.com/mcp/spare-email-mcp): Spare Email MCP is an open-source MCP server for communication.
- [Replyz](https://ai-powered.com/mcp/replyz): Replyz is a free MCP server for communication.
- [Dead Simple Email](https://ai-powered.com/mcp/dead-simple-email): Dead Simple Email is a freemium MCP server for communication.
- [Emitd MCP Server](https://ai-powered.com/mcp/emitd-mcp-server): Emitd MCP Server is a freemium MCP server for communication.
- [Flowmails](https://ai-powered.com/mcp/flowmails): Flowmails is an MCP server for communication.

---
Source: https://ai-powered.com/mcp/email
