| name | granola-cli |
| description | Search and inspect Granola meeting notes, folders, summaries, attendees, and transcripts via the granola CLI |
Granola CLI (granola)
Use this skill when the user wants to inspect or search Granola notes and transcripts.
The CLI uses the official Granola public API plus a local synced cache.
Quick Reference
granola search "query" - Search cached notes
granola list - List recent cached notes
granola folders - List folders inferred from cached notes
granola show <note-id> - Show a cached note
granola show <note-id> --transcript - Show a note with transcript
granola sync - Refresh the local cache
Important Behavior
list, search, folders, and show may run an implicit sync first unless you pass --no-sync.
- Granola does not expose server-side full-text search or a documented folders endpoint, so search and folder filtering run against the local cache.
- Folder filtering is derived from each note's
folder_membership metadata.
--person and --folder use case-insensitive substring matching.
- Date-only filters like
--after 2026-04-01 use local day boundaries.
Output Formats
Prefer structured output for agent use:
--json - pretty JSON
--ndjson - one JSON object per line for list-like outputs
--full - include richer fields in structured output
Commands
Authentication
granola auth login
granola auth status
granola auth logout
Sync
granola sync
granola sync --full
granola sync --json
Notes
granola list
granola list --limit 10
granola list --person "Alice"
granola list --folder "1:1"
granola list --after 2026-04-01 --before 2026-04-30
granola list --json
granola list --ndjson --full
Folders
granola folders
granola folders --person "Alice"
granola folders --after 2026-04-01
granola folders --json
granola folders --ndjson
Search
granola search "roadmap"
granola search "roadmap hiring"
granola search "roadmap" --person "Alice"
granola search "roadmap" --folder "Leadership"
granola search "pricing" --after 2026-04-01
granola search "pricing" --json
granola search "pricing" --ndjson --full
Show
granola show <note-id>
granola show <note-id> --transcript
granola show <note-id> --json
granola show <note-id> --json --full
Skill installation
granola skill install claude-code
granola skill install codex
granola skill install cursor
granola skill install gemini
granola skill install pi
granola skill install universal
granola skill list
granola skill uninstall <agent>
Update & changelog
granola update
granola update --check
granola update --channel
granola update switch --stable
granola update switch --pre-release
granola changelog
granola changelog -n 3
Examples
Find a note and inspect the transcript
granola search "customer pricing" --json | jq -r '.results[0].id'
granola show <note-id> --transcript
List notes for a specific folder
granola list --folder "Leadership"
Search for all notes involving a person
granola search "roadmap" --person "Alice"