About agent-mail
agent-mail is MailKite’s MCP library for AI agents, supporting outbound email through a verified domain and inbound mail via webhooks. It can also route incoming messages to a built-in inbox agent to answer, file, or escalate them.
Key features
- 01Send email from a verified domain
- 02Receive email through webhooks
- 03Manage domains
- 04Search MailKite documentation
- 05Route inbound mail to an inbox agent
Use cases
- 01Give an AI agent its own inbox
- 02Send email using a verified domain
- 03Have an inbox agent handle incoming mail
- 04Manage MailKite email functions from an MCP client
MCP support
The library exposes MailKite API methods as tools for MCP clients. It can use the hosted HTTP MCP service or run locally with a static API key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.mailkite.dev/mcp?ref=agent-mailclaude mcp add --transport http dev-mailkite-agent-mail https://mcp.mailkite.dev/mcp?ref=agent-mail{"mcpServers":{"dev-mailkite-agent-mail":{"type":"http","url":"https://mcp.mailkite.dev/mcp?ref=agent-mail"}}}Open in Cursor{"servers":{"dev-mailkite-agent-mail":{"type":"http","url":"https://mcp.mailkite.dev/mcp?ref=agent-mail"}}}Open in VS Code{"mcpServers":{"dev-mailkite-agent-mail":{"type":"http","url":"https://mcp.mailkite.dev/mcp?ref=agent-mail"}}}{"mcpServers":{"dev-mailkite-agent-mail":{"serverUrl":"https://mcp.mailkite.dev/mcp?ref=agent-mail"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project README@mailkite/mcp
Email for every product you ship — receive email as a webhook, send over a verified domain, give an AI agent its own inbox.
The official MailKite library for AI agents (MCP).
Docs · Library guide · mailkite.dev · AI agents
Read-only mirror. This repo is a generated, release-time mirror of the MailKite monorepo (the private source of truth) — development doesn't happen here. Install from npm and open issues against the MailKite docs.
Install
{
"mcpServers": {
"mailkite": {
"command": "npx",
"args": ["-y", "@mailkite/mcp"],
"env": { "MAILKITE_API_KEY": "mk_live_…" }
}
}
}
Tools
One tool per MailKite API method, generated from the shared contract. Full list + schemas: https://mailkite.dev/docs/libraries#mcp.
Use it from an AI agent — MCP + Agent connectors
MailKite speaks the Model Context Protocol: every API method is a tool your AI assistant (Claude, Cursor, …) can call — send mail, manage domains, search the docs, and give an agent its own inbox. Full guide: https://mailkite.dev/docs/ai-agents.
Hosted (recommended) — one-click OAuth, no key to copy:
claude mcp add --transport http mailkite https://mcp.mailkite.dev/mcp
In Claude Code you can also install the plugin:
/plugin marketplace add mailkite/claude-code
/plugin install mailkite@mailkite
Any chat/UI agent: "Add the MCP server at https://mcp.mailkite.dev/mcp and authenticate in the browser when prompted."
Local (static key, offline / CI):
{ "mcpServers": { "mailkite": { "command": "npx", "args": ["-y", "@mailkite/mcp"], "env": { "MAILKITE_API_KEY": "mk_live_…" } } } }
Give an agent its own inbox. Route inbound mail to a built-in inbox agent (the agent route action) and it answers, files, or escalates on its own — see https://mailkite.dev/docs/ai-agents.
All MailKite libraries
Same contract, every language — pick the one for your stack (full list: https://mailkite.dev/docs/libraries):
| Library | Repo | Distribution |
|---|---|---|
| MailKite for Node.js | mailkite-node | npm |
| MailKite for Python | mailkite-python | PyPI |
| MailKite for Ruby | mailkite-ruby | RubyGems |
| MailKite for Java | mailkite-java | Maven Central |
| MailKite for PHP | mailkite-php | Packagist |
| MailKite for Go | mailkite-go | Go modules |
| @mailkite/cli | mailkite-cli | npm |
| @mailkite/mcp (this repo) | mailkite-mcp | npm |
| @mailkite/client | mailkite-js | npm |
| @mailkite/expo | mailkite-expo | npm |
| MailKiteClient | mailkite-swift | Swift Package Manager |
| dev.mailkite:mailkite-client | mailkite-kotlin | Maven Central |
| mailkite_client | mailkite-flutter | pub.dev |
Docs & links
- 📚 Documentation: https://mailkite.dev/docs
- 📦 This library's guide: https://mailkite.dev/docs/libraries#mcp
- 🤖 AI agents (MCP + inbox agents): https://mailkite.dev/docs/ai-agents
- 🌐 Website: https://mailkite.dev
- 🧭 All libraries: https://mailkite.dev/docs/libraries
Generated from the shared MailKite API contract. © MailKite.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.