mcpField
G
granola

granola

github.com/glebis生産性401229 回インストール1 日前に更新
リポジトリ

granola について

Granola Meeting Importer は、Granola のノート一覧や詳細、文字起こしを確認し、Obsidian に書き出すコマンドラインスキルです。Granola Personal API を利用し、Fathom スキルと同じ形式でエクスポートします。

主な機能

  1. 01日付でノート一覧を絞り込み
  2. 02ノートの詳細と文字起こしを表示
  3. 03Obsidian Markdownへエクスポート
  4. 04テキストまたはJSON出力
  5. 05全件をページネーション取得

活用シーン

  1. 01最近のGranola会議ノートを確認
  2. 02会議の文字起こしを調べる
  3. 03ノートをObsidianのVaultに保存

インストール

コマンドをコピーしてターミナルで実行します。

$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 が必要です）
  • sops で暗号化された ~/Brains/brain/.env.granola に API キーを設定します（GRANOLA_API_KEY=grn_...）
  • 追加の依存関係はありません（標準ライブラリのみ使用します）

使用方法

python3 ~/.claude/skills/granola/scripts/granola.py <command> [options]
コマンド
コマンド説明
listPersonal 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 リクエスト、継続時は 5 リクエスト／秒
  • 重要：API が返すのは生成済みの要約があるノートのみです。進行中のミーティングは表示されません

既知の制限事項

  • 進行中のミーティングにはアクセスできません — ノートが表示されるのは、Granola が AI 要約を生成した後のみです
  • 発話ごとの話者名はありません — Granola が提供するのは source（マイクかスピーカーか）と任意の diarization_label です。エクスポート時には、マイクの発話にミーティングの主催者を割り当てます
  • ノート ID が必要です — まず list を実行して not_xxxx ID を取得し、その後 show／export を実行します

統合

  • transcript-analyzer：エクスポート後、出力ファイルに対して transcript-analyzer を実行すると、より詳細な分析を行えます
  • Fathom スキル：Granola のエクスポートは Fathom のエクスポートと同じフロントマターおよびトランスクリプト形式を使用するため、後続のツールはどちらにも対応できます

コメント

Markdown 対応