Granola MCP
官方通过MCP将Claude、ChatGPT及其他AI工具连接到你的Granola会议笔记。查询笔记、搜索转录内容,并在你喜爱的AI助手中获取会议洞察。
你可以用 Granola MCP 做什么?
- 搜索会议笔记 — 对过去的会议提问,并使用
query_granola_meetings获取答案。 - 浏览会议列表 — 通过
list_meetings获取最近的会议,包括标题、日期和参与者,可选择按文件夹筛选。 - 提取行动项和决策 — 使用
get_meetings获取完整的会议内容,以呈现待办任务或关键结果。 - 查看会议记录 — 使用
get_meeting_transcript拉取原始记录,以查找确切引文或重新查看详细讨论(付费计划)。 - 列出会议文件夹 — 使用
list_meeting_folders查看您所属的所有文件夹,包括笔记数量(付费计划)。 - 确认已连接的账户 — 使用
get_account_info验证哪个 Granola 账户和工作区处于活动状态。
文档
Granola MCP
通过 MCP 将 Claude、ChatGPT 及其他 AI 工具连接到您的 Granola 会议笔记。在您喜爱的 AI 助手中查询笔记、搜索转录内容并获取会议洞察。
使用 Granola MCP 将您的 AI 工具连接到 Granola 会议笔记。连接后,您可以:搜索会议笔记、查找过往会议中讨论过的特定主题、浏览会议文件夹、从笔记中提取行动项或决策、根据会议历史回答问题等。
我们目前仅支持通过浏览器 OAuth 进行身份验证。如需其他形式的身份验证,请将反馈发送至 hey@granola.so。
Granola MCP 目前可供公开测试,但请注意,可用性和功能未来可能会发生变化。设置指南
前提条件
- 拥有现有会议笔记的 Granola 账户
- 支持 MCP 的 AI 工具,例如 Claude 和 ChatGPT
如何连接
1. 打开并登录 Claude2. 前往“设置”
3. 前往“连接器”,搜索 Granola
4. 连接、进行身份验证,并确保在聊天时已开启开关
1. 打开并登录 ChatGPT
2. 前往“设置”
3. 搜索“Granola”并连接
4. 现在您可以在 ChatGPT 中 @Granola 或直接要求引用您的会议
1. 在终端中运行 `claude`
2. 运行此命令:
```bash theme={null}
claude mcp add granola --transport http https://mcp.granola.ai/mcp
```
3. 打开一个新的终端标签页,然后再次运行 `claude`
4. 运行 `/mcp`,选择 granola MCP,然后选择“身份验证”
5. 要求 Claude 引用您的会议
您可以通过使用公共 URL{" "}
[https://mcp.granola.ai/mcp](https://mcp.granola.ai/mcp) 作为自定义连接,手动连接到 Granola MCP。
您的 AI 工具必须支持:
* **MCP 客户端协议**,使用 [Streamable HTTP 传输](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
* **OAuth 2.0 身份验证** — 服务器使用基于浏览器的 OAuth,因此您的工具需要能够打开浏览器窗口,以便用户登录 Granola。登录后,工具会收到一个不记名令牌,用于后续请求。
每个用户通过浏览器 OAuth 流程单独进行身份验证。MCP 没有 API 密钥或服务账户访问方法。
<Info>
如果您需要用于脚本、自动化或自定义集成的 API 密钥访问,请改用我们的 [Granola API](./granola-api)。
</Info>
工具和描述
| 工具 | 描述 | 示例提示 |
|---|---|---|
query_granola_meetings | 与 Granola 聊天 | 在此处查看完整聊天示例 |
list_meeting_folders | 仅限付费计划 — 列出您所属的文件夹,包括文件夹 ID、标题、描述和笔记数量 | 我可以访问哪些会议文件夹? |
list_meetings | 浏览您的会议列表,包括:会议 ID、会议标题、会议日期、与会者。在付费计划中,还包括与您共享的笔记,并可按文件夹筛选。 | 我上周和 Sam 开了哪些会? |
get_meetings | 搜索您的会议内容,包括:会议 ID、会议标题、会议日期、与会者、私人笔记、增强笔记。在付费计划中,当您拥有会议 ID 时,还可以获取与您共享的笔记。 | 这个项目每个人剩余的行动项是什么? |
get_meeting_transcript | 仅限付费计划 — 深入查看您的转录内容,包括:会议 ID、原始转录文本 | 给出团队描述该问题的具体引述 |
get_account_info | 返回当前连接到此 MCP 会话的 Granola 账户的电子邮件和活动工作区 — 当您拥有多个账户(例如个人和工作账户)时,可用于确认您连接了正确的 Granola 账户 | 我当前登录的是哪个 Granola 账户? |
故障排除指南
速率限制将根据您的 Granola 订阅计划和您正在使用的 MCP 工具而有所不同。目前,所有工具的速率限制平均约为每分钟 100 个请求。速率限制可能会发生变化。<Info>
如果您使用的是 Basic(免费)计划,则只能查询过去 30 天内的笔记。
</Info>
如果您收到消息,提示您的 LLM 代理无法访问您的会议笔记或使用 Granola MCP 工具,请尝试重新进行身份验证。
如果 Granola 在 Claude 中已连接,但显示 **没有可用工具**,请在 Claude 中重新连接 Granola 连接器以重置连接:
1. 在网页上前往 [Claude 连接器设置](https://claude.ai/customize/connectors)。即使您使用 Claude 桌面应用,也必须在 claude.ai 上执行此操作。
2. 选择 **Granola**。
3. 点击右上角的三点菜单。
4. 选择 **断开连接**。
5. 在不刷新页面或离开页面的情况下,再次选择 **连接** 并完成身份验证。
<Info>
如果您使用的是 Claude 团队或企业计划,可能需要工作区管理员为您断开并重新连接 Granola。
</Info>
如果您在完成 OAuth 登录流程后看到此错误,可能是您用于身份验证的电子邮件地址与注册 Granola 账户时使用的电子邮件地址不同。
要检查您的 Granola 账户使用哪个电子邮件,请打开 Granola 应用并前往 **设置**(macOS 上为 <kbd>⌘</kbd> + <kbd>,</kbd>,Windows 上为 <kbd>Ctrl</kbd> + <kbd>,</kbd>)。您的账户电子邮件显示在左上角个人资料图片下方。
重新连接 MCP 时,请确保在 OAuth 流程中使用相同的电子邮件地址登录。
如果您的 AI 工具提示找不到任何笔记,或者在您知道有会议时未返回任何结果,则 MCP 可能连接到了错误的 Granola 账户,或者连接到了正确账户中的错误工作区。
询问您的 AI 工具:**“我当前登录的是哪个 Granola 账户?”** 它将使用 `get_account_info` 工具返回当前连接到 MCP 的电子邮件和活动工作区。然后:
* **电子邮件正确,工作区错误**:在 Granola 桌面应用中切换工作区(点击左上角的工作区名称并选择正确的工作区)。MCP 会跟随您的活动工作区,因此下一次查询将使用它。
* **电子邮件完全错误**:按照下方 **使用错误的账户登录 Claude** 折叠面板中的步骤(或适用于您 AI 工具的等效步骤)断开连接,并使用正确的账户重新连接。
以下是如何使用不同的 Granola 账户重新连接 Claude MCP 的方法:
1. 打开一个无痕/隐私浏览窗口并登录 claude.ai。
2. 前往 **设置 -> 连接器** 并断开 Granola 连接。
3. 仍在无痕模式下,重新连接 Granola。这将提示您再次登录,因此请使用您的主要 Granola 账户电子邮件。
4. 连接后,切换回您的正常浏览器,它应该会使用正确的账户工作。
正常的断开/重新连接无法解决此问题的原因是,您现有的 Granola 会话保持活动状态,因此会跳过登录步骤。无痕模式会强制进行全新登录,从而让您选择正确的账户。
一般常见问题解答
不需要,您可以为 AI 工具和 Granola 使用不同的账户。您将对希望 AI 工具访问的 Granola 账户进行身份验证。要验证您的 Granola 账户使用哪个电子邮件,请打开 Granola 应用并前往 **设置**(macOS 上为 ⌘ + ,,Windows 上为 Ctrl + ,)— 您的账户电子邮件显示在左上角个人资料图片下方。 您通过 MCP 可以访问的内容取决于您的计划:* **免费计划:** 您过去 30 天内自己的笔记。
* **付费计划:** 您自己的笔记,以及与您共享的笔记和您所属的私人文件夹中的笔记。
MCP 只能访问您“我的笔记”(私人)空间中的文件夹。团队空间中的文件夹永远无法通过 MCP 访问,即使您创建了它们并明确添加了所有成员。
要使团队空间文件夹可通过 MCP 访问,请使用文件夹的共享设置将其从团队空间移至“我的笔记”,然后明确添加需要访问权限的每个团队成员。请注意,默认情况下,这些文件夹将不再对整个工作区可见。
这应该会立即生效,并且您将在下一次查询时获得额外的工具和升级后的速率限制。
不需要。Granola MCP 使用基于浏览器的 OAuth 和动态客户端注册 (DCR),这意味着凭据会自动处理。您无需生成或输入任何客户端 ID 或客户端密钥。
如果您使用的第三方平台(如 Composio)显示客户端 ID 和客户端密钥字段,请将它们留空 — 平台将在您连接时自动向 Granola 注册。
是的 — 任何实现 [MCP 客户端规范](https://modelcontextprotocol.io/) 并使用 Streamable HTTP 传输的工具都可以连接到 Granola MCP。您的工具需要处理 OAuth 2.0 浏览器身份验证流程,以便每个用户可以登录其 Granola 账户。有关技术细节,请参阅上文的“其他 AI 工具”部分。
如果您正在构建自定义集成并需要帮助,请联系 [hey@granola.so](mailto:hey@granola.so)。
企业常见问题解答
是的,MCP 可供企业客户使用。管理员可以通过前往 **设置 → 工作区 > 通用** 并开启 MCP 来为其工作区启用 MCP。<img src="https://mintcdn.com/granola-c3940166/rTtxUdgB05Bp81mq/help-center/sharing/integrations/mcp-enterprise-toggle.png?fit=max&auto=format&n=rTtxUdgB05Bp81mq&q=85&s=4932feaa5122c0254d19ea94a224f35f" alt="MCP toggle in workspace settings" width="1200" height="217" data-path="help-center/sharing/integrations/mcp-enterprise-toggle.png" />
默认情况下,MCP 对所有工作区成员禁用。管理员可以在 **设置 → 工作区 > 通用** 中启用它。
MCP 开关位于 **设置 → 工作区 > 通用**。所有企业工作区成员都可以看到该开关,但只有管理员可以更改——非管理员会看到它处于禁用状态,并显示提示“仅工作区管理员可编辑”。如果你需要启用 MCP,请让你的工作区管理员将其打开。
我们正在开发更多企业功能,包括高级访问控制、使用情况监控与分析、更高的速率限制以及灵活的定价选项(更多信息即将发布!)