mcpField
G
granola

granola

github.com/glebisProductivity401229 installsUpdated 1d ago
Repository

About granola

Granola Meeting Importer is a command-line skill for listing Granola notes, viewing details and transcripts, and exporting notes to Obsidian. It uses Granola's Personal API and formats exports to match the Fathom skill.

Key features

  1. 01List notes with date filtering
  2. 02View note details and transcripts
  3. 03Export notes as Obsidian Markdown
  4. 04Text or JSON output
  5. 05Paginate through all results

Use cases

  1. 01Review recent Granola meeting notes
  2. 02Inspect a meeting transcript
  3. 03Save a note in an Obsidian vault

Install

Copy the command and run it in a terminal.

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

After installing, type/granolain Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with 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

Details

From the project README

Granola Meeting Importer

Query Granola via Personal API to list notes, view transcripts, and export to Obsidian vault in the same format as the Fathom skill.

Prerequisites

  • Granola Business or Enterprise plan (Personal API required)
  • API key in sops-encrypted ~/Brains/brain/.env.granola as GRANOLA_API_KEY=grn_...
  • No additional dependencies (uses stdlib only)

Usage

python3 ~/.claude/skills/granola/scripts/granola.py <command> [options]
Commands
CommandDescription
listList notes from Personal API
show <note_id>Show note details (summary, attendees, optionally transcript)
export <note_id>Export note to Obsidian markdown (Fathom-compatible format)
Options
OptionApplies toDescription
--format text|jsonlist, showOutput format (default: text)
--after <ISO date>listFilter notes created after date
--alllistPaginate through all results
--transcriptshowInclude transcript in output
--vault <path>exportObsidian vault path (default: ~/Brains/brain)
--output <path>exportCustom output file path

Examples

List recent meetings
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
Show note with transcript
python3 ~/.claude/skills/granola/scripts/granola.py show not_5FkswTp4Omkpm5
python3 ~/.claude/skills/granola/scripts/granola.py show not_5FkswTp4Omkpm5 --transcript --format json
Export to Obsidian
python3 ~/.claude/skills/granola/scripts/granola.py export not_5FkswTp4Omkpm5
python3 ~/.claude/skills/granola/scripts/granola.py export not_5FkswTp4Omkpm5 --vault ~/Brains/brain

Output Format

Exported notes match Fathom skill format for consistency:

---
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...

Files saved as: Sessions/YYYYMMDD-meeting-title-slug.md

API Details

  • Base URL: https://public-api.granola.ai/v1
  • Auth: Bearer token (Personal API key, never expires)
  • Rate limits: 25 req burst / 5 req/sec sustained
  • Important: API only returns notes with generated summaries — in-progress meetings won't appear

Known Limitations

  • No live/in-progress access — notes appear only after Granola generates the AI summary
  • No per-utterance speaker names — Granola provides source (microphone vs speaker) and optional diarization_label. Export assigns meeting owner to microphone utterances
  • Note IDs required — use list first to get not_xxxx IDs, then show/export

Integration

  • transcript-analyzer: After export, run transcript-analyzer on the output file for deeper analysis
  • Fathom skill: Granola exports use the same frontmatter and transcript format as Fathom exports, so downstream tools work with both

Comments

Markdown supported