Granola Meeting Importer

Prerequisites

• Granola desktop app installed and authenticated (macOS)
• No additional dependencies required (uses stdlib only)

Usage

python3 ~/.claude/skills/granola/scripts/granola.py <command> [options]

Commands

list

show <id>

transcript <id>

export <id>

api-list

Options

--format text|json

--local-only

--vault <path>

--output <path>

--limit <n>

--offset <n>

Examples

List meetings

python3 ~/.claude/skills/granola/scripts/granola.py list
python3 ~/.claude/skills/granola/scripts/granola.py list --format json

Export to Obsidian

python3 ~/.claude/skills/granola/scripts/granola.py export bbeba240
python3 ~/.claude/skills/granola/scripts/granola.py export "Подкаст"

Get transcript

python3 ~/.claude/skills/granola/scripts/granola.py transcript bbeba240
python3 ~/.claude/skills/granola/scripts/granola.py transcript "Подкаст" --format json

Output Format

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

# Meeting Title

## Summary
{AI-generated summary if available}

## Notes
{Markdown notes if available}

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

YYYYMMDD-meeting-title-slug.md

Data Sources

1. Cache file:

   ~/Library/Application Support/Granola/cache-v*.json

   (currently v6) -- metadata for all meetings, transcripts for active/recent meetings only. The script auto-detects the latest version.
2. API token:

   ~/Library/Application Support/Granola/supabase.json

   -- WorkOS bearer token for API calls (auto-refreshed when app is open, ~6h expiry)

references/cache-structure.md

Known Limitations

• Transcript content is sparse in cache -- only the most recent/active meeting typically has a full transcript locally. Older ones require API fetch.
• No per-utterance speaker names -- Granola only provides

  source

  (microphone vs system audio). The export assigns the meeting creator to microphone utterances and "Other" to system audio.
• Notes/summaries often empty -- Granola stores rich content server-side; the local cache has stubs. The API also returns empty for personal (non-workspace) docs.
• Token expiry -- if the Granola app hasn't been open recently, the token may be expired. Open the app to refresh.

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