# agents-mail MCP server

> Provides a self-hosted mailbox on Cloudflare Workers that lets AI agents receive, search, send, and wait for emails via MCP or REST.

- Repository: https://github.com/nikuscs/agents-mail
- Page: https://hostedmcp.org/servers/nikuscs/agents-mail
- Transport: —
- Stars: 5
- License: MIT

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `AGENTS_MAIL_TOKEN` | no | no |  |

## Tools (8)

- `list_emails`
- `get_email`
- `wait_for_email`
- `send_email`
- `reply_email`
- `forward_email`
- `mark_email`
- `delete_email`

## FAQ

### What happens to my existing email domain when I deploy this?

Email Routing will replace your domain's MX records, meaning any existing mailboxes on that domain (like Gmail or Outlook) will stop receiving mail.

### Can I use this with Claude Code?

Yes, it works with Claude Code and any MCP client via the /mcp endpoint.

### How do I secure my mailbox?

Everything is guarded by a single bearer token, and you can optionally set up a separate read-only token.
