# agent-mail [Health: Active] **Category:** ๐Ÿ’ฌ Communication **Repository:** https://github.com/mailkite/mailkite-mcp **GitHub Stars:** 0 **npm Downloads (last month):** 613 **Views:** 1 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/agent-mail ## Description Give an AI agent its own inbox โ€” receive email as a webhook, send over a verified domain. ## Tools Capabilities this server exposes over MCP: - **mailkite_send** โ€” Send a message over a verified domain. - **mailkite_send_batch** โ€” Send one personalized message per recipient (up to 50) in a single call. - **mailkite_upload_attachment** โ€” Upload a file to MailKite storage and get back a secure, time-limited URL. - **mailkite_list_templates** โ€” List your saved email templates (light metadata only โ€” no body). - **mailkite_list_base_templates** โ€” List the premade base templates (light metadata). - **mailkite_get_template** โ€” Get one template (full: subject, html, text, theme). - **mailkite_create_template** โ€” Create a template. - **mailkite_list_domains** โ€” List your domains, each with its webhook URL. - **mailkite_create_domain** โ€” Add a domain. - **mailkite_get_domain** โ€” Get one domain with DNS records + webhook. - **mailkite_delete_domain** โ€” Remove a domain. - **mailkite_verify_domain** โ€” Check DNS and update status. - **mailkite_set_webhook** โ€” Set or replace the domain's catch-all webhook. - **mailkite_set_tracking_webhook** โ€” Set or replace the domain's dedicated tracking-event webhook: an HTTPS endpoint that receives signed email.* engagement events (email.sent / email.bounced / email.complained / email.opened / email.clicked, shaped per the tracking-event schema) SEPARATELY from inbound mail. - **mailkite_delete_tracking_webhook** โ€” Remove the domain's tracking-event webhook (engagement events stop). - **mailkite_set_webhook_events** โ€” Opt the domain's inbound webhook into engagement events โ€” one webhook, all events. - **mailkite_delete_webhook_events** โ€” Opt the domain's inbound webhook back out of engagement events (inbound email.received only โ€” the default). - **mailkite_delete_webhook** โ€” Remove the domain's webhook. - **mailkite_test_webhook** โ€” Send a signed test event to the domain's webhook. - **mailkite_check_domain_availability** โ€” Check whether a domain is available to register, and at what price. - **mailkite_register_domain** โ€” Register (buy) a domain on the customer's behalf; provisions mail DNS and adds it to the account in one call. - **mailkite_list_routes** โ€” List inbound routing rules. - **mailkite_create_route** โ€” Create a route (match, action, destination). - **mailkite_delete_route** โ€” Delete an inbound routing rule by id. - **mailkite_agent** โ€” Send a message to one of your inbox agents and get its reply. - **mailkite_route** โ€” Route a message to one of your registered routes (by `routeId` or `address`), running that route's action โ€” agent, webhook, or forward. - **mailkite_list_messages** โ€” List stored messages, newest first. - **mailkite_get_message** โ€” Get a message with deliveries + attachments. - **mailkite_retry_delivery** โ€” Re-deliver a stored message to its webhook. - **mailkite_list_lists** โ€” List your contact lists (static, curated broadcast audiences), each with its member count. - **mailkite_create_list** โ€” Create a contact list. - **mailkite_get_list** โ€” Get one contact list with its member count. - **mailkite_update_list** โ€” Rename a contact list. - **mailkite_delete_list** โ€” Delete a contact list. - **mailkite_list_list_contacts** โ€” List the contacts that are members of a list, newest first. - **mailkite_add_list_contacts** โ€” Add contacts (by id, ctr_โ€ฆ) to a list. - **mailkite_remove_list_contact** โ€” Remove one contact from a list (the contact itself is kept). - **mailkite_list_broadcasts** โ€” List your broadcasts (one-to-many sends) with status and send stats. - **mailkite_create_broadcast** โ€” Create a broadcast draft. - **mailkite_get_broadcast** โ€” Get one broadcast with its status and recipient summary. - **mailkite_update_broadcast** โ€” Edit a draft broadcast (any of from/subject/audience/html/โ€ฆ ). - **mailkite_delete_broadcast** โ€” Delete a broadcast draft. - **mailkite_send_broadcast** โ€” Send a broadcast now, or pass an ISO 8601 `scheduledAt` to schedule it. - **mailkite_verify_webhook** โ€” Verify the `x-mailkite-signature` header on an inbound webhook delivery. - **mailkite_semantic_search** โ€” Semantic search over the MailKite documentation โ€” returns the most relevant doc sections for a natural-language query (hybrid vector + keyword search over https://mailkite.dev/docs). - **mailkite_set_retention** โ€” Toggle zero-retention passthrough for the domain ({ zeroRetention }). - **mailkite_set_encryption** โ€” Enable at-rest encryption for the domain with a public key ({ publicKey }). - **mailkite_delete_encryption** โ€” Disable at-rest encryption for the domain. - **mailkite_list_schemas** โ€” List every published JSON Schema with the URL it is served from. - **mailkite_get_schema** โ€” Fetch one schema as application/schema+json, with an absolute $id a validator can resolve and cache. - **mailkite_signup** โ€” Create an account. - **mailkite_login** โ€” Log in with email + password. - **mailkite_google_signin** โ€” Sign in with a Google auth code. - **mailkite_get_api_key** โ€” Get the account's unrestricted API key (mk_live_โ€ฆ). - **mailkite_rotate_api_key** โ€” Rotate the account API key: the old key stops working immediately and a fresh one is returned. - **mailkite_list_scoped_keys** โ€” List the account's domain-scoped API keys. - **mailkite_create_scoped_key** โ€” Create a key scoped to one domain. - **mailkite_delete_scoped_key** โ€” Revoke a domain-scoped key. - **mailkite_list_app_passwords** โ€” List the account's app passwords. - **mailkite_create_app_password** โ€” Create an app password for one domain and address pattern. - **mailkite_delete_app_password** โ€” Revoke an app password. - **mailkite_list_mailbox_messages** โ€” List a mailbox's messages, newest first. - **mailkite_get_mailbox_message_raw** โ€” Fetch one message's raw RFC822 bytes from a mailbox. - **mailkite_set_mailbox_message_flags** โ€” Replace a message's IMAP flags (e.g. - **mailkite_get_usage** โ€” Current billing-period usage: emails used vs the plan's included bucket (null = unlimited), AI actions, and the overage state that gates sending. - **mailkite_list_suppressions** โ€” List suppressed addresses (unsubscribes, hard bounces, spam complaints, manual). - **mailkite_add_suppression** โ€” Suppress an address so this account never sends to it again (reason defaults to manual). - **mailkite_remove_suppression** โ€” Remove an address from the suppression list (URL-encode the email in the path). - **mailkite_register** โ€” Create a MailKite account from just an email โ€” no password. - **mailkite_me** โ€” The account behind this credential: email, whether it is verified (sending is blocked until it is), and plan. ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "agent-mail": { "command": "npx", "args": ["-y","@mailkite/mcp"] } } ``` ## Documentation & README

MailKite

@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

npm MailKite MCP server โ€“ quality and maintenance score on Glama

> **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](https://mailkite.dev/docs). ## Install ```json { "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](https://modelcontextprotocol.io): 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](https://mailkite.dev/docs/ai-agents)**. **Hosted (recommended) โ€” one-click OAuth, no key to copy:** ```bash claude mcp add --transport http mailkite https://mcp.mailkite.dev/mcp ``` In Claude Code you can also install the plugin: ```text /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):** ```json { "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](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](https://mailkite.dev/docs/libraries)): | Library | Repo | Distribution | | --- | --- | --- | | MailKite for Node.js | [`mailkite-node`](https://github.com/mailkite/mailkite-node) | npm | | MailKite for Python | [`mailkite-python`](https://github.com/mailkite/mailkite-python) | PyPI | | MailKite for Ruby | [`mailkite-ruby`](https://github.com/mailkite/mailkite-ruby) | RubyGems | | MailKite for Java | [`mailkite-java`](https://github.com/mailkite/mailkite-java) | Maven Central | | MailKite for PHP | [`mailkite-php`](https://github.com/mailkite/mailkite-php) | Packagist | | MailKite for Go | [`mailkite-go`](https://github.com/mailkite/mailkite-go) | Go modules | | @mailkite/cli | [`mailkite-cli`](https://github.com/mailkite/mailkite-cli) | npm | | @mailkite/mcp **(this repo)** | [`mailkite-mcp`](https://github.com/mailkite/mailkite-mcp) | npm | | @mailkite/client | [`mailkite-js`](https://github.com/mailkite/mailkite-js) | npm | | @mailkite/expo | [`mailkite-expo`](https://github.com/mailkite/mailkite-expo) | npm | | MailKiteClient | [`mailkite-swift`](https://github.com/mailkite/mailkite-swift) | Swift Package Manager | | dev.mailkite:mailkite-client | [`mailkite-kotlin`](https://github.com/mailkite/mailkite-kotlin) | Maven Central | | mailkite_client | [`mailkite-flutter`](https://github.com/mailkite/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.