Inbox MCP

Inbox MCP

立即将你的收件箱变成智能的、由大模型驱动的助手。

借助基于 Nylas v3 构建的强大、适合批量处理的工具，通过对话轻松管理、整理并简化电子邮件。开箱即兼容 Gmail、Outlook、iCloud、Yahoo，以及几乎所有 IMAP 服务（甚至包括你的工作邮箱！）。

这些工具经过精心设计，提供清晰的说明和一致的参数，针对与各种大模型无缝集成进行了优化。响应以易于解析的 XML 块形式提供，让大模型可以轻松处理你的请求。

Inbox MCP 在真实工作流中经过广泛测试，可显著减轻认知负担，高效处理你更愿意自动化完成的任务。

Nylas 提供 5 个免费连接的账户，因此你可以立即开始使用，无需花一分钱。

---

✨ 真实场景示例（你实际会说的话）

你随口说……	Inbox MCP 会轻松帮你……
“看看我的收件箱，告诉我哪些邮件重要，以及我需要处理什么”	检查邮件，快速找出需要采取行动的邮件，并总结需要关注的事项。
“找出最近 100 封邮件中不重要的邮件，并把它们移到‘不重要’文件夹。”	智能筛除优先级较低的邮件，并将其整齐地归档，让它们不再碍眼。
“归档所有两周前的邮件，但保留已加星标的邮件。”	批量归档较早的邮件，同时安全保留已加星标的邮件。
“总结最新的 AWS 提醒并转发给我的团队。”	汇总近期 AWS 提醒，生成简洁的摘要并立即发送。

---

🎯 为什么使用 Inbox MCP？

• 轻松实现收件箱清零： 使用自然语言指令，快速自动化电子邮件管理。
• 高效分拣： 轻松即时地分类、确定优先级并批量处理电子邮件。
• 轻松设置： 直接连接账户，轻松完成初始设置。无需 OAuth 令牌、代理或复杂配置。

---

📌 快速设置：创建 Nylas 账户

1. 在此注册：Nylas Dashboard。
2. 从侧边栏获取 API 密钥（API KEY）。
   
3. 前往 Grants，点击右上角的 Add Test Grant，然后连接你的电子邮件账户。
   
4. 记下 API 密钥和 Grant ID（显示在 grants 表格中）。

---

🚀 开始使用（不到一分钟）

轻松通过 Smithery 安装（交互式）

Inbox MCP 可与 Claude Desktop、Cursor、Windsurf 等 MCP 客户端无缝集成。

交互式单行安装（推荐）：

npx -y @smithery/cli@latest install "@darinkishore/inbox-mcp" --client claude

系统会提示你输入 Nylas 凭据（nylasAccessToken 和 nylasGrantId）。对于其他受支持的 MCP 客户端，将 claude 替换为你偏好的客户端：

npx -y @smithery/cli@latest install "@darinkishore/inbox-mcp" --client cursor # or windsurf, vscode, etc.

---

🛠️ 手动本地设置（可选）

如果你更喜欢在本地开发时手动控制：

git clone https://github.com/darinkishore/Inbox-MCP.git
cd Inbox-MCP
npm install && npm run build

然后，在 MCP 客户端的 mcp-config.json 中：

{
  "mcpServers": {
    "nylas-email": {
      "command": "node dist/index.js",
      "workingDirectory": "/absolute/path/to/Inbox-MCP",
      "env": {
        "NYLAS_ACCESS_TOKEN": "...",
        "NYLAS_GRANT_ID": "..."
      }
    }
  }
}

---

🔧 日常工作流工具（优化版）

工具	功能说明（通俗易懂）
filter_emails	按文件夹、未读状态、日期或标记快速查找邮件。
triage_update_emails	批量将邮件设为已读/未读、加星/取消加星，或移至其他文件夹。
batch_archive_emails	安全、快速地归档多组邮件。
search_emails	使用简单的关键词查询快速搜索邮件。
read_emails	获取完整邮件，并以格式整洁的 Markdown 呈现，非常适合用于生成摘要。
send_email / draft_email	轻松撰写并发送（或保存为草稿）新邮件。
文件夹管理工具	（list_、create_、update_、delete_、get_or_create_）

---

🗺️ 路线图

• 增强原生提供商搜索（高级查询、多关键词搜索）
• 集成日历和联系人
• 扩展工具集和自动化能力

---

👩‍💻 开发者友好

• 简洁的 TypeScript（v5.2），依赖项精简
• 内置可靠的重试机制（指数退避 + 随机抖动）
• 欢迎大家踊跃贡献——让我们携手改进邮件管理！

---

📄 许可证与支持

基于 MIT 许可协议授权。

如果 Inbox MCP 让你的日常更轻松，请点个 ⭐️——你的星标也能帮助其他人发现它！