mcpField
G
granola

granola

github.com/glebis生产力401229 次安装1 天前更新
代码仓库

关于 granola

Granola Meeting Importer 是用于列出 Granola 笔记、查看详情与转录文本，并导出到 Obsidian 的命令行技能。它通过 Granola Personal API 获取笔记，导出格式与 Fathom 技能一致。

主要功能

  1. 01按日期筛选笔记列表
  2. 02查看笔记详情和转录文本
  3. 03导出为 Obsidian Markdown
  4. 04支持文本或 JSON 输出
  5. 05分页获取全部结果

适用场景

  1. 01查看近期 Granola 会议笔记
  2. 02检查会议转录文本
  3. 03将笔记保存到 Obsidian 库

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/glebis/claude-skills --skill granola

安装后在 Claude Code 中输入/granola确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

.claude-plugin/
plugin.json
references/
cache-structure.md
scripts/
granola.py
sync.sh
scripts/tests/
__init__.py
test_cmd_export.py
test_cmd_list.py
test_cmd_show.py
test_compute_duration.py
test_extract_calendar_times.py
test_extract_people.py
test_format_time.py
test_load_cache.py
scripts/tests/fixtures/
cache_object_state.json
cache_string_state.json

详细介绍

Granola 会议导入器

通过 Personal API 查询 Granola，以列出笔记、查看转录，并按照与 Fathom 技能相同的格式导出到 Obsidian 知识库。

前提条件

  • Granola Business 或 Enterprise 套餐（需要 Personal API）
  • API 密钥位于经过 sops 加密的 ~/Brains/brain/.env.granola 中，格式为 GRANOLA_API_KEY=grn_...
  • 无需额外依赖（仅使用标准库）

用法

python3 ~/.claude/skills/granola/scripts/granola.py <command> [options]
命令
命令说明
list从 Personal API 列出笔记
show <note_id>显示笔记详情（摘要、参会者，可选转录）
export <note_id>将笔记导出为 Obsidian Markdown（兼容 Fathom 的格式）
选项
选项适用命令说明
--format text|jsonlist、show输出格式（默认：text）
--after <ISO date>list筛选指定日期之后创建的笔记
--alllist翻页获取所有结果
--transcriptshow在输出中包含转录
--vault <path>exportObsidian 知识库路径（默认：~/Brains/brain）
--output <path>export自定义输出文件路径

示例

列出近期会议
python3 ~/.claude/skills/granola/scripts/granola.py list
python3 ~/.claude/skills/granola/scripts/granola.py list --format json
python3 ~/.claude/skills/granola/scripts/granola.py list --after 2026-05-01
显示包含转录的笔记
python3 ~/.claude/skills/granola/scripts/granola.py show not_5FkswTp4Omkpm5
python3 ~/.claude/skills/granola/scripts/granola.py show not_5FkswTp4Omkpm5 --transcript --format json
导出到 Obsidian
python3 ~/.claude/skills/granola/scripts/granola.py export not_5FkswTp4Omkpm5
python3 ~/.claude/skills/granola/scripts/granola.py export not_5FkswTp4Omkpm5 --vault ~/Brains/brain

输出格式

导出的笔记采用与 Fathom 技能一致的格式：

---
granola_id: not_xxxx
title: "Meeting Title"
date: YYYY-MM-DD
participants: ['Name 1', 'Name 2']
duration: HH:MM
source: granola
---

# Meeting Title

## Summary
{AI-generated summary}

## Transcript
**Speaker Name**: What they said...

文件保存为：Sessions/YYYYMMDD-meeting-title-slug.md

API 详情

  • 基础 URL：https://public-api.granola.ai/v1
  • 身份验证：Bearer 令牌（Personal API 密钥，永不过期）
  • 速率限制：突发速率为 25 req / 持续速率为 5 req/sec
  • 重要说明：API 仅返回已生成摘要的笔记——进行中的会议不会显示

已知限制

  • 无法访问实时或进行中的会议——只有在 Granola 生成 AI 摘要后，笔记才会显示
  • 没有逐句发言者名称——Granola 提供 source（麦克风或扬声器）和可选的 diarization_label。导出时会将会议所有者指定为麦克风发言内容的发言者
  • 需要笔记 ID——先使用 list 获取 not_xxxx ID，再使用 show/export

集成

  • transcript-analyzer：导出后，对输出文件运行 transcript-analyzer 以进行深入分析
  • Fathom 技能：Granola 导出内容与 Fathom 导出内容使用相同的 frontmatter 和转录格式，因此下游工具可同时处理两者

评论

支持 Markdown