# AgentMail MCP

> Give your agent its own email inboxes to send, receive, reply to and search mail, schedule drafts and keep a calendar.

AgentMail's own hosted MCP server. AgentMail gives AI agents real email inboxes through an API, and this server lets your agent create and run those inboxes from the chat: send, reply, forward and search mail, work with drafts and attachments, keep an inbox's calendar, and create accounts for your agent at other apps with AgentID.

What you can do with it
- Create, find, update and delete inboxes
- Send, reply to and forward email, and list or full-text search messages and threads
- Write drafts and schedule them to send later
- Read attachments, with extracted text for PDF and DOCX files
- Keep an inbox's calendar: see the agenda, create or change events, send invites and answer invitations
- Manage each inbox's allow and block lists for sending, receiving and replying
- Create an account for your agent at an app such as Firecrawl with AgentID, and see which apps your inboxes have accounts at

How it connects
AgentMail hosts it at https://mcp.agentmail.to/mcp over Streamable HTTP. In Claude, ChatGPT and Claude Code you sign in at console.agentmail.to the first time (OAuth), and pick an organization if you belong to more than one. Agents that can't do that sign-in can send an AgentMail API key in an x-api-key header instead; create one in the console under Settings, then API Keys. For agents that can't send headers, AgentMail publishes a stdio bridge (npx -y agentmail-mcp, or uvx agentmail-mcp for Python).

Good to know
- You need an AgentMail account. Sign up at console.agentmail.to before you connect.
- Agents that support MCP Events, such as ChatGPT, can act on new mail as it arrives instead of checking the inbox.
- AgentMail documents setup for ChatGPT, Claude and more, and its plugin for coding agents installs this server together with AgentMail's skills.

- Type: Plugin
- Made by: Agentmail
- Category: Communication
- Formats: Remote MCP
- Version: 1.0.0
- Website: https://docs.agentmail.to/integrations/mcp
- Source: https://github.com/agentmail-to/agentmail-mcp
- Page: https://pluginboard.ai/plugins/agentmail-mcp

## Works with

- ChatGPT
- Claude
- Muse
- Grok Bot
- Gemini
- Grok
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- Replit
- OpenClaw
- OpenCode
- Hermes Agent

## Install

### ChatGPT

In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://mcp.agentmail.to/mcp under Connection. Business and Enterprise plans; Pro can add read-only servers.

### Claude

In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://mcp.agentmail.to/mcp

### Muse

In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://mcp.agentmail.to/mcp. Then tap Connect on the card it shows and sign in, or add your key.

### Grok Bot

In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://mcp.agentmail.to/mcp". It confirms the details with you and sets it up, and the tools are ready from your next message.

### Gemini

In Gemini: At gemini.google.com: Settings → Connected Apps → Add a custom app, then paste https://mcp.agentmail.to/mcp

### Grok

In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://mcp.agentmail.to/mcp and sign in if it asks.

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22agentmail-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.agentmail.to%2Fmcp%22%7D

Copilot CLI:

```shell
copilot mcp add --transport http agentmail-mcp https://mcp.agentmail.to/mcp
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=agentmail-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5hZ2VudG1haWwudG8vbWNwIn0%3D

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "agentmail-mcp": {
      "url": "https://mcp.agentmail.to/mcp"
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add --transport http agentmail-mcp https://mcp.agentmail.to/mcp
```

### Codex

Run in your terminal:

```shell
codex mcp add agentmail-mcp --url https://mcp.agentmail.to/mcp
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "agentmail-mcp": {
      "url": "https://mcp.agentmail.to/mcp"
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add --transport http agentmail-mcp https://mcp.agentmail.to/mcp
```

### Replit

In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://mcp.agentmail.to/mcp (add any headers under Advanced settings), then click Test & save.

### OpenClaw

Run in your terminal:

```shell
openclaw mcp add agentmail-mcp --url https://mcp.agentmail.to/mcp --transport streamable-http
```

If it needs a key or sign-in: For https://mcp.agentmail.to/mcp, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login agentmail-mcp.

### OpenCode

Run in your terminal:

```shell
opencode mcp add agentmail-mcp --url https://mcp.agentmail.to/mcp
```

If it needs a key: For https://mcp.agentmail.to/mcp, add --header 'NAME=value' for each header it needs. Add --global to use it in every project.

### Hermes Agent

Run in your terminal:

```shell
hermes mcp add agentmail-mcp --url https://mcp.agentmail.to/mcp
```

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "agentmail-mcp": {
      "url": "https://mcp.agentmail.to/mcp"
    }
  }
}
```

If it signs in with OAuth: If https://mcp.agentmail.to/mcp asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry.

---
From Pluginboard (https://pluginboard.ai).