Granola Claude MCP

格兰诺拉克劳德MCP服务器

将您的会议数据转化为基于人工智能的商业智能

连接的自定义模型上下文协议（MCP）服务器 格拉诺拉.ai 将会议数据直接发送到Claude Desktop，实现整个会议历史记录的自然语言查询。

  

______________________________________________________________________

🚀 为什么存在

虽然Granola MCP在网上有详细的功能列表和安装指南， 实际的存储库和PyPI包不存在我们没有等待正式发布，而是对Granola的本地缓存结构进行了逆向工程，并从头开始构建了一个全面的MCP服务器。

结果如何？ 问克劳德以下问题：

• *“向我展示上个月我们讨论预算的所有客户会议”*
• *“哪些团队成员需要安然项目会议的跟进？”*
• *“分析我们与外部客户的会议模式与内部团队会议”*

✨ 特性

🔍 自然语言会议智能

• 使用简明英语查询273+个会议
• 在标题、内容和参与者列表中搜索
• 即时访问会议元数据和日历集成

📊 高级分析

• 会议统计和模式识别
• 与会者分析和参与度跟踪
• 从会议历史重建项目时间表

🔗 完全集成

• 谷歌日历活动详情和与会者回复
• 会议链接（谷歌会议、缩放）和参与状态
• 丰富的元数据，包括组织者、响应状态和共享设置

🛡️ 隐私优先架构

• 所有数据处理都在本地进行，没有云上传
• 直接缓存文件访问-无API依赖项
• 尊重现有的Granola权限和访问控制

🎯 用例

项目管理

"Show meetings about the XXI Media project and identify next steps"
→ Surfaces July 16 Zoom meeting with Pyxl, attendee status, action items

客户关系

"Which clients had 'needsAction' responses this week?"
→ Identifies follow-up requirements across all client touchpoints

团队分析

"Who attends the most external client meetings?"
→ Analyzes workload distribution and development opportunities

满足投资回报率

"Compare meeting outcomes between Google Meet vs Zoom sessions"
→ Platform effectiveness analysis for future planning

🛠️ 安装

先决条件

• macOS 已安装并配置Granola.ai
• Python 3.12+
• 克劳德桌面 应用
• 活跃的格兰诺拉麦片会议历史

快速开始

1. 克隆存储库

   git clone https://github.com/[USERNAME]/granola-claude-mcp.git
   cd granola-claude-mcp

1. 使服务器可执行

   chmod +x granola_mcp_server.py

1. 测试安装

   python3 test_granola.py

您应该看到：

   ✅ Cache loaded successfully!
   📊 Statistics: [your meeting data]
   📅 Recent meetings: [your recent meetings]

1. 配置Claude桌面

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

   {
     "mcpServers": {
       "granola-mcp": {
         "command": "python3",
         "args": ["/path/to/granola-claude-mcp/granola_mcp_server.py"],
         "env": {
           "GRANOLA_CACHE_PATH": "/Users/[username]/Library/Application Support/Granola/cache-v3.json"
         }
       }
     }
   }

1. 重新启动克劳德桌面

完全退出（⌘+Q）并重新启动Claude Desktop。

1. 测试集成

问克劳德： *“显示我最近参加的格兰诺拉麦片会议”*

🔧 可用工具

get_recent_meetings

获取包含完整元数据的最新会议

Parameters: limit (integer, max 50)
Returns: Meeting list with titles, dates, attendees, calendar integration

search_meetings

跨会议标题和内容搜索

Parameters: query (string), limit (integer, max 20)
Returns: Matching meetings with relevance scoring

get_meeting_details

深入了解特定的会议数据

Parameters: meeting_id (string)
Returns: Complete meeting information including notes, attendees, conference details

get_statistics

跨会议语料库的分析

Parameters: none
Returns: Meeting counts, transcript availability, word counts, trends

🏗️ 建筑

数据流

Granola.ai → Local Cache → MCP Server → Claude Desktop → AI Intelligence

缓存结构

Granola使用复杂的“双JSON”编码：

# Standard JSON file containing JSON string
cache_data = json.loads(data['cache'])
state = cache_data['state']

# Three primary data collections:
documents = state['documents']        # 273+ meeting records
metadata = state['meetingsMetadata']  # 28 relationship objects  
transcripts = state['transcripts']    # 16 available transcripts

MCP协议实现

• 完全符合MCP 2025-06-18协议
• 正确的初始化和能力协商
• 错误处理和优雅降级
• 具有亚秒级响应的实时查询处理

🐛 故障排除

Claude Desktop中的“服务器失败”

1. 查看日志：Claude Desktop→ 设置→ 开发者→ 打开日志文件夹
2. 验证配置中的文件路径
3. 手动测试服务器： python3 granola_mcp_server.py

“未找到会议”

1. 确保Granola.ai已处理会议
2. 验证缓存文件是否存在： ls -la ~/Library/Application\ Support/Granola/
3. 检查缓存文件大小（对于活动用户，应该是几MB）

Python/权限问题

1. 验证Python 3.12+： python3 --version
2. 使服务器可执行： chmod +x granola_mcp_server.py
3. 检查Granola缓存目录上的文件权限

MCP连接问题

1. 完全重新启动克劳德桌面（⌘+Q，然后重新打开）
2. 在claude_desktop_config.JSON中验证JSON语法
3. 检查环境变量路径是否与您的用户名匹配

🤝 贡献

我们欢迎捐款！该项目填补了人工智能生产力生态系统中的一个真正空白。

贡献方式：

• 🐛 错误报告：特定会议形式或边缘案例的问题
• ✨ 功能请求：附加分析、导出格式、集成思路
• 🔧 代码贡献：性能改进，额外的MCP工具
• 📚 文档：设置指南、用例示例、故障排除

开发设置

git clone https://github.com/[USERNAME]/granola-claude-mcp.git
cd granola-claude-mcp

# Test your changes
python3 test_granola.py

# Run the server manually for debugging
python3 granola_mcp_server.py

📋 路线图

第二阶段：高级分析

• \[\]带有动作项提取的转录分析
• \[\]会议有效性情绪分析
• \[\]自动跟进推荐引擎
• \[\]跨会议主题和决策跟踪

第三阶段：增强集成

• \[\]实时缓存监控实时更新
• \[\]多平台会议数据（谷歌日历之外）
• \[\]导出功能（PDF报告、CSV分析）
• \[\]用于会议情报的仪表板web界面

第四阶段：企业特性

• \[\]具有访问控制的多用户部署
• \[\]CRM集成，实现完整的客户生命周期跟踪
• \[\]高级报告和商业智能
• \[\]用于第三方集成的API开发

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🙏 致谢

• Anthropic 用于模型上下文协议规范
• 格拉诺拉.ai 用于构建复杂的会议智能（即使MCP集成是MIA）
• MCP社区 示例和最佳实践

📞 支持

• 问题:
• 讨论:
• 专业服务：有关自定义集成和企业部署，请联系 科布尔山

______________________________________________________________________

⭐ 如果此回购能帮助您从会议中提取更多价值，请将其标记为星号！

*内置于❤️ 由团队在 科布尔山 -人工智能集成专家*