Skill
granola
Every Granola feature — plus offline SQLite cross-meeting search, attendee timelines, and a MEMO pipeline runner...
When to use granola
Choose if
You're an agent that needs to mine Granola's meeting transcripts for MEMO pipeline runs, attendee timelines, or pre-call prep — and you want the speed of a local SQLite mirror plus the option to fall back to the desktop cache when no API key is configured. Typed exit codes let the agent self-correct on auth or sync drift.
Avoid if
You're not already a Granola user — the CLI has no way to backfill meetings the desktop app hasn't already recorded. Also avoid when you need write operations to flow through guardrails you haven't configured — four mutable commands (delete, restore, import, warm --launch) can destroy local data if the agent runs them unfettered.
Risk Flags
- MEDIUM auth Three auth surfaces with fallthrough (API key, WorkOS access token, or desktop cache). WorkOS tokens expire and require desktop-app refresh or falling back to the API key. Stale credentials surface as exit code 4.
- MEDIUM data_quality MEMO pipeline runs can report duplicate_of when a file with the same title-date-attendees fingerprint already exists. Recent transcripts may show as missing until Granola flushes them — agents must handle the timing dependency on the upstream sync.
- MEDIUM scope Four mutable commands exist (delete, restore, import, warm --launch) despite the CLI being read-only by default. Agents granted full permissions can delete Granola data — gate with safety flags or --enable-commands / --disable-commands.
- LOW runtime Local cache fallback requires an active Granola desktop installation; cache-path override is manual if the install isn't in the default location.
Cost
Type: Freemium · Free tier: The CLI is MIT-licensed and free to install. It can fall back to the local Granola desktop cache when no API key is configured, which works for personal use without any paid plan.
Hidden costs
- The CLI relies on either a Granola desktop install (free cache fallback) or a GRANOLA_API_KEY for public API access. The Granola product itself has paid tiers; the CLI's commercial terms are not published in the README.
Install
Default
npx -y @mvanhorn/printing-press install granola
Estimated time to first success: ~10 min
Dependencies
Minimum runtime: Node.js (for npx); pre-built binaries available for macOS / Unix
Distribution
- Repository
- https://github.com/mvanhorn/printing-press-library
- License
- MIT