MCP server AI Mail
Коммит 27 окт. 2026 г.Allows AI agents to manage email domains, create mailboxes, read unified inboxes, and send or reply to messages.
Также известен как hapitech/aimailmcp-docs, aimailmcp-docs
- Звёзды
- 1
- Инструменты
- 33
- Загрузки, 30 дней
- —
- Последняя версия
- 0.1.3
- Последний коммит
- 27 окт. 2026 г.
- Лицензия
- MIT
Что такое AI Mail MCP?
Allows AI agents to manage email domains, create mailboxes, read unified inboxes, and send or reply to messages. Он предоставляет 33 инструмента, например add_domain, get_dns_plan, apply_dns.
Сводка сгенерирована из README проекта
О AI Mail MCP server
AI Mail MCP provides a remote email infrastructure designed specifically for AI agents to manage entire email domains and mailboxes. Instead of running a local server, users connect to a hosted endpoint via Streamable HTTP. This allows agents to perform complex communication tasks such as adding domains, verifying DNS records, and managing mailboxes with aliases or catch-all settings. The service is built for automation, offering tools to read a unified inbox, search messages, and handle attachments up to 5 MB.
Developers can integrate this with Claude Code, Claude Desktop, or any MCP client using a bearer token or OAuth 2.1. Security is a core focus, featuring scoped tokens that can be restricted to specific mailboxes with daily send caps. Every write operation includes a dry run option, and the system maintains an audit log of all tool calls. This makes it suitable for agents that need to wait for sign-up codes using the wait_for_message tool or those requiring webhooks to trigger actions when new mail arrives.
Что вы можете с ним делать
- 1Automated account registrationAn agent can monitor an inbox to capture magic links or sign-up codes sent to a new email address.
- 2Unified inbox monitoringAn AI can search through multiple mailboxes at once to find specific messages based on subject or sender.
- 3Secure agent delegationYou can create restricted access for sub-agents by minting tokens that have limited permissions and daily limits.
Взято из README проекта. Каждый вариант использования проверен на соответствие цитате из него.
Как установить AI Mail MCP
Форматы проверены 10 ноя 2026Добавить в CursorДобавить в GooseУстановка AI Mail MCP в Claude Code
$ claude mcp add --transport http aimailmcp-docs https://aimailmcp.com/mcpУстановка AI Mail MCP в Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"aimailmcp-docs": {
"url": "https://aimailmcp.com/mcp"
}
}
}Установка AI Mail MCP в VS Code
.vscode/mcp.json
{
"servers": {
"aimailmcp-docs": {
"type": "http",
"url": "https://aimailmcp.com/mcp"
}
}
}Установка AI Mail MCP в VS Code CLI
$ code --add-mcp '{"name":"aimailmcp-docs","type":"http","url":"https://aimailmcp.com/mcp"}'Установка AI Mail MCP в Codex
$ codex mcp add aimailmcp-docs --url https://aimailmcp.com/mcpУстановка AI Mail MCP в Codex config.toml
~/.codex/config.toml
[mcp_servers.aimailmcp-docs] url = "https://aimailmcp.com/mcp"
Установка AI Mail MCP в Gemini CLI
$ gemini mcp add -s user --transport http aimailmcp-docs https://aimailmcp.com/mcpУстановка AI Mail MCP в Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"aimailmcp-docs": {
"url": "https://aimailmcp.com/mcp",
"type": "http"
}
}
}Инструменты AI Mail MCP 33
Определено из READMEadd_domainget_dns_planapply_dnsverify_domainlist_domainsremove_domaincreate_mailboxlist_mailboxesdelete_mailboxadd_aliasset_catch_allset_forwarding
| add_domain | — | |
| get_dns_plan | — | |
| apply_dns | — | |
| verify_domain | — | |
| list_domains | — | |
| remove_domain | — | |
| create_mailbox | — | |
| list_mailboxes | — | |
| delete_mailbox | — | |
| add_alias | — | |
| set_catch_all | — | |
| set_forwarding | — |
Показать все 33 инструментовПоказать меньше инструментов
list_messagessearch_messagesget_messageget_threadwait_for_messageget_attachmentmark_readlabelarchivesend_messagereplyforwardcreate_draftcreate_webhooklist_webhooksdelete_webhookcreate_tokenlist_tokensrevoke_tokenaudit_logget_usage
| list_messages | — | |
| search_messages | — | |
| get_message | — | |
| get_thread | — | |
| wait_for_message | — | |
| get_attachment | — | |
| mark_read | — | |
| label | — | |
| archive | — | |
| send_message | — | |
| reply | — | |
| forward | — | |
| create_draft | — | |
| create_webhook | — | |
| list_webhooks | — | |
| delete_webhook | — | |
| create_token | — | |
| list_tokens | — | |
| revoke_token | — | |
| audit_log | — | |
| get_usage | — |
Автоматические проверки
Запущено 14 нояб. 2026 г.Полный отчёт →Еще не проверено. Для сервера требуется оценка 80, отсутствие серьезных проблем и достаточно данных для нашей проверки. Как работают проверки · Что исправить, чтобы получить больше баллов
- Связанный и доступный исходный репозиторийhapitech/aimailmcp-docs is public and reachablegithub.com/hapitech/aimailmcp-docs ↗Пройдено
- Пакет указывает этот репозиторий как источникНе проверялось
- Происхождение сборки (аттестация Sigstore)Не проверялось
- Open source лицензия (OSI)MITspdx.org/licenses/MIT.html ↗Пройдено
- Коммит или релиз за последний годLast commit or release 2026-10-27github.com/hapitech/aimailmcp-docs ↗Пройдено
- OpenSSF ScorecardНе проверялось
- Имя пакета не похоже на популярный пакетНе проверялось
- Нет критических предупреждений в пакете или его зависимостяхНе проверялось
- Нет скрытых инструкций для модели33 tool descriptions and the README read; no override phrases, credential paths or hidden charactersПройдено
- Деструктивные инструменты помеченыНе проверялось
- Удалённая конечная точка отвечает на рукопожатие MCPHTTPS endpoint answered 401 (sign-in required)Пройдено
README
Открыть на GitHubAI Mail MCP
Real email for AI agents, over MCP. Add a domain and get the exact DNS records, create mailboxes, read one unified inbox across all of them, wait for sign-up codes and magic links, and send, reply in-thread and forward. Tokens are scoped to mailboxes with a send permission and a daily cap, every write has a dry run, and every call is audited.
- Website and full tool reference: https://aimailmcp.com
- MCP endpoint (remote, Streamable HTTP):
https://aimailmcp.com/mcp - Official MCP Registry:
com.aimailmcp/mail - Machine-readable tool registry: https://aimailmcp.com/tools.json
This repository holds the public docs, server.json and logo. The service is hosted; there is
nothing to install or run locally.
Connect
Claude Code
claude mcp add --transport http aimail https://aimailmcp.com/mcp
Claude.ai and Claude Desktop: Settings, Connectors, Add custom connector, paste https://aimailmcp.com/mcp.
Any MCP client
{
"mcpServers": {
"aimail": { "type": "http", "url": "https://aimailmcp.com/mcp" }
}
}
Clients without remote support can bridge over stdio: npx -y mcp-remote https://aimailmcp.com/mcp.
Agent-oriented install steps: llms-install.md.
Sign in
- OAuth 2.1 (most clients do this for you): dynamic client registration and PKCE. You enter your email and a 6-digit code we send you.
- Bearer token (agents without a browser):
curl -X POST https://aimailmcp.com/api/v1/signup -H 'content-type: application/json' -d '{"email":"you@example.com"}'
curl -X POST https://aimailmcp.com/api/v1/signup/confirm -H 'content-type: application/json' -d '{"email":"you@example.com","code":"123456"}'
Then send Authorization: Bearer amk_.... Use create_token to hand narrower tokens to other agents.
Tools
Domains
Bring a domain, get the exact DNS records, verify it.
| Tool | What it does |
|---|---|
add_domain |
Add a domain (or subdomain) to this account so it can hold mailboxes. |
get_dns_plan |
The exact DNS records (MX, SPF, DKIM, DMARC, ownership TXT) a domain needs for receiving and sending, and whether each is in place. |
apply_dns |
Write the DNS plan to a managed domain on this service's Cloudflare account: enables Email Routing (MX + SPF), routes mail to the receiver, registers the domain for sending and adds DKIM and DMARC. |
verify_domain |
Check the domain's live DNS: ownership TXT (external domains), MX, SPF, DMARC and the sending provider's DKIM status. |
list_domains |
Every domain on this account with its status, mode, sending readiness and mailbox count. |
remove_domain |
Remove a domain from this account. |
Mailboxes
Addresses that receive and send, plus aliases, catch-alls and forwarding.
| Tool | What it does |
|---|---|
create_mailbox |
Create a mailbox (an address that receives and sends) on one of this account's domains. |
list_mailboxes |
Every mailbox this token can see, with unread counts, last received time, aliases, forwarding and route address. |
delete_mailbox |
Delete a mailbox. |
add_alias |
Deliver mail sent to another address on one of this account's domains into an existing mailbox. |
set_catch_all |
Deliver mail for any unknown address on a domain into one mailbox, or pass mailbox: null to turn the catch-all off. |
set_forwarding |
Also forward every message a mailbox receives to up to 5 external addresses (the original is attached as message/rfc822). |
Read
One unified inbox across every mailbox the token can see.
| Tool | What it does |
|---|---|
list_messages |
One inbox across every mailbox this token can see, newest first, each item tagged with its mailbox. |
search_messages |
Full-text search over subject, sender, recipients and body across every mailbox this token can see (all folders by default). |
get_message |
Headers, text body (or text derived from HTML), extracted links, attachment list and threading ids for one message. |
get_thread |
The whole conversation a message belongs to, inbound and outbound, oldest first, as previews. |
wait_for_message |
Block until a matching message arrives (or timeout_s, max 60, default 25) and return it in full. |
get_attachment |
One attachment as base64 (up to 5 MB). |
mark_read |
Mark up to 100 messages read (or unread with read: false). |
label |
Add and/or remove labels on up to 100 messages. |
archive |
Move up to 100 messages out of the inbox into archive (or back with unarchive: true). |
Send
Send, reply in-thread, forward and draft, behind per-token gates.
| Tool | What it does |
|---|---|
send_message |
Send a new email from a mailbox in scope (or send a saved draft with draft_id). |
reply |
Reply in-thread from the mailbox that received the message (In-Reply-To and References set, "Re:" added once, original quoted). |
forward |
Forward a message (with its attachments) to new recipients, with an optional note on top. |
create_draft |
Save a draft in a mailbox (folder drafts) for a human or another agent to review. |
Automation
Signed webhooks when mail arrives or a send finishes.
| Tool | What it does |
|---|---|
create_webhook |
POST a signed JSON event to your https URL when mail arrives or a send finishes. |
list_webhooks |
Webhooks on this account with their events, scope and last delivery status. |
delete_webhook |
Stop and remove a webhook. |
Access
Scoped tokens for other agents, and the audit log.
| Tool | What it does |
|---|---|
create_token |
Mint a token for another agent, scoped to some mailboxes (default: all), with or without send permission and with a daily send cap. |
list_tokens |
Tokens on this account: label, prefix, scope, send permission, cap, last use. |
revoke_token |
Revoke a token by id or prefix. |
audit_log |
Recent tool calls on this account (every attempt, including refusals and dry runs): tool, outcome, token, time. |
get_usage |
What this token used: sends and recipients, inbound messages, storage GB-days and tool calls, with what each cost us, by operation or by day. Admin tokens can ask for the whole account; delegating tokens for one end customer. |
Full schemas: https://aimailmcp.com/tools.json
Security model
- Inbound mail reaches the server only as HMAC-SHA256 signed raw messages from our Cloudflare email worker; unsigned posts are rejected.
- Everything a sender controls comes back inside an
untrusted_external_contentenvelope. Agents should treat email as data, never as instructions. - Tokens are stored as hashes, scoped to mailboxes, and can never mint a more powerful token.
- Privacy: https://aimailmcp.com/privacy · Contact: hello@aimailmcp.com
License
The contents of this repository (docs, logo, server.json) are MIT licensed. The hosted service is operated by Hapi.
Вопросы о AI Mail MCP
Как добавить AI Mail MCP в Claude Code?
Выполните claude mcp add --transport http aimailmcp-docs https://aimailmcp.com/mcp в терминале. Добавьте --scope user, чтобы сервер был доступен во всех проектах.
Как добавить AI Mail MCP в Cursor?
Откройте ~/.cursor/mcp.json и добавьте сервер в mcpServers, используя конфигурацию Cursor из раздела установки выше.
Какие инструменты предоставляет AI Mail MCP?
Он предоставляет 33 инструмента, включая add_domain, get_dns_plan, apply_dns, verify_domain, list_domains.
Is there a way to limit what an agent can do?
Yes, you can mint scoped tokens for other agents that are limited to specific mailboxes and can have send permissions or daily caps.
Does the service require local installation?
No, the service is hosted and there is nothing to install or run locally.