AI Mail MCP server
Commit 27 Okt 2026Memungkinkan AI agent untuk mengelola domain email, membuat mailbox, membaca inbox terpadu, serta mengirim atau membalas pesan.
Juga dikenal sebagai hapitech/aimailmcp-docs, aimailmcp-docs
- Stars
- 1
- Tools
- 33
- Unduhan, 30 hari
- —
- Versi terbaru
- 0.1.3
- Commit terakhir
- 27 Okt 2026
- Lisensi
- MIT
Apa itu AI Mail MCP?
AI Mail adalah MCP server. Memungkinkan AI agent untuk mengelola domain email, membuat mailbox, membaca inbox terpadu, serta mengirim atau membalas pesan. Server ini menyediakan 33 tool, seperti add_domain, get_dns_plan, apply_dns.
Ringkasan dibuat dari README proyek
Tentang AI Mail MCP server
AI Mail MCP menyediakan infrastruktur email jarak jauh yang dirancang khusus bagi AI agent untuk mengelola seluruh domain email dan mailbox. Alih-alih menjalankan server lokal, pengguna terhubung ke endpoint hosted melalui Streamable HTTP. Hal ini memungkinkan agent untuk melakukan tugas komunikasi yang kompleks seperti menambahkan domain, memverifikasi DNS records, dan mengelola mailbox dengan alias atau pengaturan catch-all.
Developer dapat mengintegrasikan ini dengan Claude Code, Claude Desktop, atau client MCP lainnya menggunakan bearer token atau OAuth 2.1. Keamanan menjadi fokus utama, dengan fitur scoped tokens yang dapat dibatasi pada mailbox tertentu dengan batas pengiriman harian. Setiap operasi penulisan menyertakan opsi dry run, dan sistem menyimpan audit log dari semua tool calls. Ini membuatnya sangat cocok untuk agent yang perlu menunggu kode pendaftaran menggunakan tool wait_for_message atau agent yang membutuhkan webhook untuk memicu aksi saat email baru masuk.
Apa yang bisa Anda lakukan dengannya
- 1Registrasi akun otomatisSeorang agent dapat memantau inbox untuk menangkap magic links atau kode pendaftaran yang dikirim ke alamat email baru.
- 2Pemantauan inbox terpaduAI dapat mencari di berbagai mailbox sekaligus untuk menemukan pesan spesifik berdasarkan subjek atau pengirim.
- 3Delegasi agent yang amanAnda dapat membuat akses terbatas untuk sub-agent dengan membuat token yang memiliki izin terbatas dan limit harian.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal AI Mail MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal AI Mail MCP di Claude Code
$ claude mcp add --transport http aimailmcp-docs https://aimailmcp.com/mcpInstal AI Mail MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"aimailmcp-docs": {
"url": "https://aimailmcp.com/mcp"
}
}
}Instal AI Mail MCP di VS Code
.vscode/mcp.json
{
"servers": {
"aimailmcp-docs": {
"type": "http",
"url": "https://aimailmcp.com/mcp"
}
}
}Instal AI Mail MCP di VS Code CLI
$ code --add-mcp '{"name":"aimailmcp-docs","type":"http","url":"https://aimailmcp.com/mcp"}'Instal AI Mail MCP di Codex
$ codex mcp add aimailmcp-docs --url https://aimailmcp.com/mcpInstal AI Mail MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.aimailmcp-docs] url = "https://aimailmcp.com/mcp"
Instal AI Mail MCP di Gemini CLI
$ gemini mcp add -s user --transport http aimailmcp-docs https://aimailmcp.com/mcpInstal AI Mail MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"aimailmcp-docs": {
"url": "https://aimailmcp.com/mcp",
"type": "http"
}
}
}Tool AI Mail MCP 33
Terdeteksi dari 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 | — |
Tampilkan semua 33 toolTampilkan lebih sedikit tool
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 | — |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkauhapitech/aimailmcp-docs is public and reachablegithub.com/hapitech/aimailmcp-docs ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyaTidak diperiksa
- Provenance build (atestasi Sigstore)Tidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-10-27github.com/hapitech/aimailmcp-docs ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerTidak diperiksa
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model33 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPHTTPS endpoint answered 401 (sign-in required)Lolos
README
Lihat di 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.
Pertanyaan tentang AI Mail MCP
Bagaimana cara menambahkan AI Mail MCP ke Claude Code?
Jalankan claude mcp add --transport http aimailmcp-docs https://aimailmcp.com/mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan AI Mail MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan AI Mail MCP?
Server ini menyediakan 33 tool, termasuk add_domain, get_dns_plan, apply_dns, verify_domain, list_domains.
Apakah ada cara untuk membatasi apa yang bisa dilakukan oleh agent?
Ya, Anda dapat membuat scoped tokens untuk agent lain yang dibatasi hanya pada mailbox tertentu dan dapat diatur izin pengiriman atau batas harian (daily caps).
Apakah layanan ini memerlukan instalasi lokal?
Tidak, layanan ini bersifat hosted sehingga tidak ada yang perlu diinstall atau dijalankan secara lokal.