agent-mail — Claude Code MCP server: what it does, how to install
Connects MailKite email capabilities to your AI assistant. Sends messages from verified domains and routes inbound mail directly to agent workflows.
claude mcp add --transport http agent-mail 'https://mcp.mailkite.dev/mcp?ref=agent-mail'What agent-mail does
This integration exposes the MailKite API as callable tools. Your assistant can dispatch emails, inspect domain verification records, and browse technical references. The assistant manages message routing directly.
Two deployment options are supported. The hosted version connects over HTTP with browser-based OAuth authentication. If you run the package locally using npx -y @mailkite/mcp, an active MAILKITE_API_KEY environment variable is mandatory. Without a verified sending domain in your account, outbound message delivery will fail.
What it helps with
- send outbound messages through authenticated domains
- assign a dedicated email inbox to an agent
- route inbound webhook emails to an automated inbox handler
- verify and inspect domain status via assistant prompts
Example prompts for the agent
- Send an onboarding email to [email protected] from our verified domain
- Check the DNS verification status for domain example.org
- Set up incoming email routing to the inbox agent
How to install agent-mail
Platform CLI: remote server
claude mcp add --transport http agent-mail 'https://mcp.mailkite.dev/mcp?ref=agent-mail'Platform CLI: remote server
codex mcp add agent-mail --url 'https://mcp.mailkite.dev/mcp?ref=agent-mail'Config file
{
"mcpServers": {
"agent-mail": {
"url": "https://mcp.mailkite.dev/mcp?ref=agent-mail"
}
}
}Config file
{
"servers": {
"agent-mail": {
"type": "http",
"url": "https://mcp.mailkite.dev/mcp?ref=agent-mail"
}
}
}Platform CLI: remote server
gemini mcp add -t http agent-mail 'https://mcp.mailkite.dev/mcp?ref=agent-mail'Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about agent-mail
How do I install agent-mail in Claude Code?
Run claude mcp add --transport http agent-mail 'https://mcp.mailkite.dev/mcp?ref=agent-mail' in your terminal. You will be prompted to authenticate in your browser during setup.
What does agent-mail do?
It turns MailKite API endpoints into tools for your assistant. The agent can read incoming mail, process webhooks, and deliver messages.
Do I need an API key to use the hosted endpoint?
No, the hosted HTTP setup relies on OAuth authentication in the browser. You only need the MAILKITE_API_KEY variable if you run the local npx command.
