# agentmail-mcp

> Claude/Codex skill by [@agentmail-to](https://omgskills.com/library/agentmail-to/index.md) · 36 stars · Updated 2026-10-06

Configure or troubleshoot the hosted AgentMail MCP server for Codex, Claude Code, Cursor, Claude.ai, ChatGPT, or another Streamable HTTP MCP client. Use for installation, OAuth, API-key headers, connection failures, or MCP tool discovery. Do not use when the connection already works and the user just wants to send, check, or manage mail — use the sibling action skills for that.

## Install

```sh
git clone https://github.com/agentmail-to/agentmail-plugins /tmp/agentmail-plugins && ln -s /tmp/agentmail-plugins/skills/agentmail-mcp ~/.claude/skills/agentmail-mcp
```

## From README

AgentMail MCP Prefer the hosted Streamable HTTP server: It avoids a local Node.js process and the slower release cadence of the published local MCP package. Claude Code, Codex, and Cursor Use OAuth. Do not put an empty API key in the configuration. Claude Code can also it directly: Complete the browser sign-in on first connection. Multi-organization OAuth sessions can use the server's organization-selection tools. Claude.ai, Claude Desktop, and ChatGPT connectors These apps add the server as a connector and complete OAuth in the browser. No API key is needed. Claude.ai and Claude Desktop: Settings → Connectors → Add custom connector. Name it AgentMail, set the URL to https://mcp.agentmail.to/mcp, then click Connect and sign in at console.agentmail.to. ChatGPT: turn on Settings → Security and login → Developer mode (on a workspace plan, an admin must allow it first).

## Links

- HTML page: https://omgskills.com/library/agentmail-to/agentmail-plugins/skills/agentmail-mcp/
- GitHub: https://github.com/agentmail-to/agentmail-plugins
- Author: [@agentmail-to](https://omgskills.com/library/agentmail-to/index.md)

## More from this repo

- [agent-email-patterns](https://omgskills.com/library/agentmail-to/agentmail-plugins/skills/agent-email-patterns/index.md) — Architecture patterns for AI agents that communicate over email -- why agents need dedicated inboxes rather than human...
   - [@agentmail-to](https://omgskills.com/library/agentmail-to/index.md) · 36 stars
- [agentmail](https://omgskills.com/library/agentmail-to/agentmail-plugins/skills/agentmail/index.md) — Used to build with the AgentMail TypeScript or Python SDK for inbox, message, thread, draft, attachment, domain,...
   - [@agentmail-to](https://omgskills.com/library/agentmail-to/index.md) · 36 stars
- [agentmail-cli](https://omgskills.com/library/agentmail-to/agentmail-plugins/skills/agentmail-cli/index.md) — Operate AgentMail from a shell with the official CLI.
   - [@agentmail-to](https://omgskills.com/library/agentmail-to/index.md) · 36 stars