inboxmcp

io.github.zhlei07v0.2.0更新于 Oct 4, 2026

Read-only IMAP email for your AI agent, scoped to the mailboxes you choose, with built-in progress.

已验证Streamable HTTP可网页运行Productivity & WorkflowCommunication & Collaboration

概览

AI 生成的概览

让 AI 助手以只读方式访问指定的 IMAP 邮箱，查看新邮件并判断哪些重要。

功能
这是一个托管型 MCP 服务器，会从你连接的 IMAP 邮箱收集新邮件，并把每封邮件连同你一次性保存的自然语言指令交给你的 AI 助手。工具涵盖查看连接进度与待处理数量、租用并确认新邮件批次、列出邮箱与邮件事件、读取单封邮件或其上下文，以及记录通知/摘要/静默的决定。访问为只读：不会发送、删除、移动邮件，也不会标记为已读，服务器本身不做分类或过滤。
适用场景
适合让助手按你写的规则分拣一个或多个 IMAP 账户的来信，例如跳过验证码和银行卡提醒，同时标记客户在等待的邮件。适用于支持远程 MCP 与 OAuth 的客户端；没有事件触发能力的平台需要设置定时任务来检查新邮件。
运行要求
通过 Streamable HTTP 访问的远程 MCP 端点，使用 OAuth with PKCE，作用域为 email:read 和 consumer-state:write。需要在该服务注册账户、用应用专用密码添加邮箱并开启收集。免费方案包含 1 个邮箱，更多邮箱需要付费方案。邮箱服务商和 AI 平台可能另行收费。
安装前请注意
邮箱凭据、webhook 密钥、邮件正文和保存的偏好设置由该服务存储，邮件正文默认保留 30 天。邮件内容会传给你选择的第三方 AI 助手，由它判断重要性并决定是否通知你。访问按连接授权并可随时撤销，但该服务由外部运营方托管，且未公开源代码。

安装

在 SourceWeft 中

  1. 打开 控制台中的 inboxmcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "inboxmcp": {
      "type": "http",
      "url": "https://app.inboxmcp.ai/mcp"
    }
  }
}

README

[inboxmcp logo]

inboxmcp

Your email. Your agent. Your priorities.
A hosted MCP server that connects the IMAP inboxes you already use to your own AI agent.

Website · Dashboard · Setup guide · Claude directory · 90-second demo

[inboxmcp demo video]

This repository holds public documentation and registry metadata for the hosted service. The server source code is not published here.

What it does

inboxmcp collects new email from your mailboxes and hands each message to the AI agent you choose, together with plain-language instructions you save once. For example: "skip verification codes and card alerts; flag anything a customer is waiting on."

Your agent decides what matters and whether to notify you. inboxmcp does not classify, rank or filter your mail.

  • Read-only IMAP. inboxmcp never sends, deletes or moves messages, and never marks them as read.
  • Many providers. There are presets for Gmail, iCloud, Yahoo, Zoho, Fastmail, QQ Mail, NetEase 163/126, Alibaba Mail, Tencent Exmail, Feishu/Lark and others. Any public IMAP server on TLS port 993 also works.
  • Scoped access. You authorize each AI connection for specific mailboxes, using OAuth with PKCE, and can revoke it at any time.
  • Built-in progress. Each AI connection keeps its own checkpoint inside inboxmcp, so scheduled tasks resume without Notion pages or state files, and messages are not handled twice.
  • Encrypted at rest. Mailbox credentials, webhook keys, message bodies and saved preferences are encrypted. Message bodies are kept for 30 days by default.

Connect

Remote MCP endpoint (Streamable HTTP)https://app.inboxmcp.ai/mcp
AuthorizationOAuth with PKCE, discovered from the endpoint
Scopesemail:read, plus consumer-state:write to save this connection's processing progress
  1. Create an account at app.inboxmcp.ai, add a mailbox with an app password, and turn on collection.
  2. Add the MCP endpoint in an AI client that supports remote MCP. Sign in, choose the mailboxes, and allow both permissions.
  3. Optional: in the dashboard, under Let your AI finish setup, copy the setup request for your AI and paste it into that AI.

Platforms

AgentHow new mail reaches itStatus
Grok BotA Grok Routine with a webhook trigger. inboxmcp delivers each new email as it arrives.Working (beta)
ClaudeCommunity connector in the Claude directory, plus a Claude Scheduled task that checks for new mail (for example, hourly)Connector published. Scheduled checks need a Claude plan that includes Scheduled tasks.
ChatGPTRemote MCP. MCP Events (email.received, email.pending.v1) are available for compatible clients.App submitted for review. Event triggering in ChatGPT has not been verified yet.
Other MCP clientsAny client that supports remote MCP with OAuthReading on demand; set up your own schedule

Incoming email does not wake every platform automatically. Where a platform has no event trigger, a scheduled task checks inboxmcp at an interval you choose.

Tools

ToolPurpose
get_email_monitor_stateThis connection's progress, collection health and pending count
claim_email_batchLease the next batch of new email, with your saved instructions and a View email link
complete_email_batchConfirm only the messages that were actually handled; the rest stay pending
list_mailboxesAuthorized mailboxes and their status
list_email_eventsPaginated email events
get_email_eventOne event's metadata
read_emailOne message, with its plain-text body and saved instructions
get_email_contextEvent, message and instructions in one call
report_email_decisionLegacy: records notify/digest/silent and stops remaining Grok delivery for that event

Email content is treated as untrusted data. The connector passes it to your agent separately from your saved instructions.

Setup videos

Plans

Free includes 1 connected mailbox. Plus allows up to 3 mailboxes for US$6/month or US$60/year. Your email provider and AI platform may charge separately.

Limits

  • No POP3, outgoing mail, attachment parsing or full-text search.
  • New mail is collected about every 60 seconds. Delivery is not instant, and notifications are sent by your AI platform, not by inboxmcp.
  • Mail received before you turn on collection is not imported.

Links

Privacy · Terms · Support · Operated by MARTHA TRADE PTE. LTD. · [email protected]

来源：README.md，提交 cc75639

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.2.0最新Oct 4, 2026