agentmail-mcp
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
With your agent
Install OMGSkills skill "agentmail-to/agentmail-plugins:skills/agentmail-mcp" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/agentmail-to/agentmail-plugins /tmp/agentmail-plugins && ln -s /tmp/agentmail-plugins/skills/agentmail-mcp ~/.claude/skills/agentmail-mcpFrom 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).
More from this repo
agent-email-patterns
Architecture patterns for AI agents that communicate over email -- why agents need dedicated inboxes rather than human...
agentmail
Used to build with the AgentMail TypeScript or Python SDK for inbox, message, thread, draft, attachment, domain,...
agentmail-cli
Operate AgentMail from a shell with the official CLI.