How do I install the Granola CLI skill?

Run npx skillmds@latest add doist/granola-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Granola CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Granola CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Granola CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Granola CLI?

Doist (@doist) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Granola CLI by doist — Agent Skill

Name: Granola CLI
Author: Doist

File contents

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"

---name: granola-clidescription: 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 FormatsPrefer 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```bashgranola auth logingranola auth statusgranola auth logout```### Sync```bashgranola syncgranola sync --fullgranola sync --json```### Notes```bashgranola listgranola list --limit 10granola list --person "Alice"granola list --folder "1:1"granola list --after 2026-04-01 --before 2026-04-30granola list --jsongranola list --ndjson --full```### Folders```bashgranola foldersgranola folders --person "Alice"granola folders --after 2026-04-01granola folders --jsongranola folders --ndjson```### Search```bashgranola search "roadmap"granola search "roadmap hiring"granola search "roadmap" --person "Alice"granola search "roadmap" --folder "Leadership"granola search "pricing" --after 2026-04-01granola search "pricing" --jsongranola search "pricing" --ndjson --full```### Show```bashgranola show <note-id>granola show <note-id> --transcriptgranola show <note-id> --jsongranola show <note-id> --json --full```### Skill installation```bashgranola skill install claude-codegranola skill install codexgranola skill install cursorgranola skill install geminigranola skill install pigranola skill install universalgranola skill listgranola skill uninstall <agent>```### Update & changelog```bashgranola updategranola update --checkgranola update --channelgranola update switch --stablegranola update switch --pre-releasegranola changeloggranola changelog -n 3```## Examples### Find a note and inspect the transcript```bashgranola search "customer pricing" --json | jq -r '.results[0].id'granola show <note-id> --transcript```### List notes for a specific folder```bashgranola list --folder "Leadership"```### Search for all notes involving a person```bashgranola search "roadmap" --person "Alice"```

Frequently asked questions

Granola CLI