用途:通过 granola CLI 访问 Joel 的 Granola 会议笔记与转录文本。该 CLI 经 mcporter 封装 Granola MCP 服务器,并非直接调用 API,也不是 npm 包。
主要能力:列出会议(granola meetings,支持 --range this_week|last_week|last_30_days|custom 及 --start/--end)、获取会议详情(granola meeting <meeting-id>,含摘要与参与者)、获取完整转录(加 --transcript)、搜索会议(granola search "<query>")、检查认证与连接(granola --help,返回 connected: true 表示 MCP 传输正常)。底层 MCP 工具包括 query_granola_meetings、list_meetings、get_meetings、get_meeting_transcript。
使用方式:二进制位于 ~/.local/bin/granola,源码在 ~/Code/joelhooks/granola-cli,配置为 ~/.config/granola-cli/mcporter.json,认证自动使用 Granola 本地凭据,无需本地运行 Granola 桌面应用。所有命令返回面向代理的 JSON,带 HATEOAS next_actions。
流水线集成:检测到新会议时可触发 Inngest 事件 meeting/noted,相关函数有 check/granola-meetings、granola-check-cron(每小时 cron)、granola-backfill。
限制:时间戳均为 UTC,显示或写入 Vault 文件时需转换;get_meeting_transcript 端点限流严格,不要批量拉取转录,转录获取并发保持为 1(原并发 3 会压垮 API)。