mcp-granola

一个 MCP (Model Context Protocol) 服务器，让 AI 智能体能够访问您的 Granola 会议纪要。您可以搜索纪要、获取包含转录内容的完整纪要，并对会议历史进行分页浏览。

功能特性

• 列出纪要：支持日期筛选和基于游标的分页

• 获取完整纪要内容：包括 AI 总结和会议转录

• 搜索纪要：通过标题或总结关键词进行搜索

• 兼容 Claude Code、Gemini CLI 以及任何支持 MCP 的客户端

• 除了 MCP SDK 外，无其他外部依赖

快速开始

1. 安装

npm install @devli13/mcp-granola

或者克隆并本地安装：

git clone https://github.com/devli13/mcp-granola.git
cd mcp-granola
npm install

2. 获取 Granola API 密钥

1. 打开 Granola 桌面应用

2. 进入 Settings > API

3. 点击 Create new key

4. 复制密钥（以 grn_ 开头）

3. 配置

添加到您的 .mcp.json (Claude Code) 或 .gemini/settings.json (Gemini CLI) 中：

{
  "mcpServers": {
    "granola": {
      "command": "npx",
      "args": ["-y", "@devli13/mcp-granola"],
      "env": {
        "GRANOLA_API_KEY": "grn_your_api_key_here"
      }
    }
  }
}

或者直接运行：

GRANOLA_API_KEY=grn_your_key node server.js

配置

工具

示例：列出最近的纪要

{
  "name": "list_notes",
  "arguments": {
    "limit": 5,
    "created_after": "2025-01-01T00:00:00Z"
  }
}

示例：获取包含转录内容的纪要

{
  "name": "get_note",
  "arguments": {
    "id": "not_abc123def456",
    "include_transcript": true
  }
}

限制

• Granola API 处于测试阶段 — 端点和响应格式可能会发生变化。

• 个人 API 密钥仅能访问您拥有或直接共享给您的纪要。

• search_notes 在最近的 200 条纪要中执行客户端子字符串匹配。它不是全文搜索引擎。对于大量纪要，请改用带有日期筛选的 list_notes。

• API 仅返回已生成 AI 总结和转录的纪要。仍在处理中的纪要不会显示。

速率限制

Granola 对每个工作区实施速率限制：

贡献

欢迎提交问题和拉取请求！如有重大更改，请先开启一个 issue 进行讨论。

许可证

MIT