Granola

granola-cli

CLI client for Granola's official MCP server. Meetings, transcripts, AI notes, and natural-language queries — from the terminal, over the same OAuth-secured API the official integrations use. No local cache parsing, no token scraping.

Built on the official Rust MCP SDK (rmcp): streamable-http transport, OAuth 2.1 with dynamic client registration and PKCE, automatic token refresh.

Install

brew install random1st/tap/granola-cli

Or download a binary from releases, or build from source:

cargo install --git https://github.com/random1st/granola-cli

macOS release binaries are signed and notarized (Developer ID).

Usage

granola login                 # one-time: opens browser for Granola OAuth
granola whoami                # account + active workspace
granola meetings              # recent meetings (--range this_week|last_week|last_30_days, --folder <id>)
granola get <meeting_id>...   # notes, summary, attendees for specific meetings
granola transcript <id>       # full verbatim transcript
granola query "what did we decide about X?"   # natural-language Q&A with citations
granola folders               # meeting folders
granola tools                 # list server tools (--json for schemas)
granola call <tool> --json '{"key": "value"}'  # raw tool call
granola logout                # remove stored credentials

Credentials live in your platform config dir (~/Library/Application Support/granola-cli/credentials.json on macOS, ~/.config/granola-cli/ on Linux), mode 0600. Refresh tokens are handled automatically — login is a one-time step.

Claude Code plugin

This repo is also a Claude Code plugin marketplace shipping a granola skill that teaches Claude to use the CLI:

/plugin marketplace add random1st/granola-cli
/plugin install granola@granola-cli

License

MIT