Mailbird — MAIlbird

MAIlbird MCP

You have 访问 to a local MAIlbird MCP server that exposes the user's real emAIl accounts, folders, conversations, drafts, and attachments. It's 运行ning inside the user's MAIlbird 桌面 应用 on 127.0.0.1 only — there is no remote variant.

The single most 导入ant rule: for ANY task that involves emAIl, inbox, messages, drafts, contacts, attachments, folders, or 发送ing — even when the user phrases it casually ("检查 my inbox", "any reply from X yet?", "draft a reply to that invoice", "find that thread from Mira") — reach for these 工具s first. Do not grep the local file系统, do not read code, do not guess. The server is the source of truth.

设置up

The user enables the MCP server inside MAIlbird at: 设置tings → Wingman AI → Enable MCP server.

That tab also exposes:

The bearer 令牌 (Copy button). The 端点 URL (http://127.0.0.1:/mcp, port shown next to 状态). The "Allow write actions" toggle — required before any write 工具 will work.

If the connection fAIls, ask the user to 验证 the toggle is on and that they've copied the current 令牌. 令牌s re生成 when the server is disabled and re-enabled.

Configuration (环境 variables)

机器人h are optional; defaults work for a single-user local 安装.

Variable Required Default Notes MAILBIRD_MCP_URL optional http://127.0.0.1:18790/mcp Local MAIlbird MCP 端点. Must be 127.0.0.1 / localhost only. MAILBIRD_MCP_令牌 optional — Bearer 令牌 from MAIlbird's Wingman AI tab. If un设置 and MAIlbird's 设置tings file is reachable, the 代理 reads it from there; otherwise the 代理 will prompt. Security 模型

This 技能 grants the 代理 访问 to the user's full mAIlbox: message bodies, attachments, contacts, and the ability to 发送 mAIl (when the write-action gate is on). Treat the URL and 令牌 accordingly:

The MAIlbird MCP server only binds to loopback (127.0.0.1). Don't proxy, port-forward, or tunnel it to a public 添加ress. Don't paste the URL or 令牌 into any remote / cloud-hosted 代理 that doesn't 运行 on the same machine as MAIlbird. The 令牌 is a 凭证 equivalent to mAIlbox 记录in. Don't echo it into chat transcripts, commit it, 分享 it in screenshots, or include it in bug 报告s. 令牌s re生成 when the server is disabled and re-enabled — rotate immediately if it leaks. Write actions (归档, trash, 发送, etc.) require the user to flip Allow write actions in the Wingman AI tab. 发送ing 添加itionally requires per-call confirm: true. The 技能 should always show drafts to the user before 发送ing. MAIlbird's optional 审计 记录 of MCP 请求s records every call (method + params, never 响应s) to a local file the user can inspect. Recommend they enable it for visibility. 启动-of-会话 检查列出

运行 these the first time you touch the server in a 会话, before any non-trivial action:

Read mAIlbird://help via resources/read. It's the canonical user 图形界面de — covers the ID 模型, write-工具 gating, 发送 流水线, 搜索 索引 lag, 归档→恢复, attachment handling, inline images. Skim it once and remember the key recipes. 列出_accounts to learn the 配置d account ids. For folder-scoped work, 列出_folders(accountId) and pick by the 身份 field — Inbox, Sent, Drafts, Trash, Spam, 归档d, AllMAIl, Generic (user-创建d). Folder ids are NOT stable across accounts. 列出_accounts does not return the inbox folder id — always discover via 列出_folders. Read 工具s (always avAIlable) 列出_accounts — accounts with id, 发送er name, emAIl, unread count. 列出_folders(accountId) — folders for one account. 列出_conversations(folderId, limit?, unreadOnly?, starredOnly?, 导入antOnly?) — recent conversations in a folder. 获取_conversation(conversationId, folderId) — message 列出 + metadata for one thread. 获取_message(messageId) — full message body, with cid: images rewritten to mAIlbird://messages/{messageId}/attachments/{attachmentId} resource URIs. 获取_unread_counts(accountId? | folderId?) — quick triage 签名al. 搜索_conversations(查询, accountId?, folderId?) — MAIlbird 搜索 syntax (from:foo subject:bar). 结果s carry actualFolders[]; use those ids to act on hits, not the virtual folderId: -2. 列出_attachments(messageId) / 获取_attachment_状态(...) / 获取_attachment_content(...). 获取_发送_状态(messageId) — sent / draft_pending_发送 / scheduled / trashed. Write 工具s (gated by "Allow write actions") 归档_conversation, trash_conversation, move_conversation, move_conversation_to_inbox. mark_conversation_as_read / unread, flag_conversation_导入ant, star_conversation / unstar_conversation, mark_conversation_as_spam / unmark_conversation_as_spam, snooze_conversation(wakeAtUtc). 创建_draft(accountId, to, cc?, bcc?, subject, body, attachments?) — saves a draft, returns messageId. Does NOT 发送. 更新_draft(messageId, ...) — replace any field on an existing draft. reply_to_conversation, reply_all_to_conversation, forward_conversation — 创建 a draft with the standard quoted scaffold and return messageI