| name | granola |
| description | Read and analyze Granola.ai local meeting cache on macOS (search meetings, details, transcripts, documents, and pattern analysis) via a local TypeScript script. |
| compatibility | Requires Node.js (runs via `npx tsx`) and Granola cache at `~/Library/Application Support/Granola/cache-v3.json`. |
Granola
This skill provides local, read-only access to Granola meeting data from the cache file on disk.
Requirements
- macOS with Granola installed
- Granola cache file at
~/Library/Application Support/Granola/cache-v3.json
- Node.js with
tsx available (npx -y tsx)
Quick start
npx -y tsx {baseDir}/scripts/granola.ts search-meetings --query "roadmap"
Commands
npx -y tsx {baseDir}/scripts/granola.ts search-meetings --query "quarterly planning" [--limit 10] [--json]
npx -y tsx {baseDir}/scripts/granola.ts get-meeting-details --meeting-id <meeting-id> [--json]
npx -y tsx {baseDir}/scripts/granola.ts get-meeting-transcript --meeting-id <meeting-id> [--json]
npx -y tsx {baseDir}/scripts/granola.ts get-meeting-documents --meeting-id <meeting-id> [--json]
npx -y tsx {baseDir}/scripts/granola.ts analyze-meeting-patterns --pattern-type topics|participants|frequency [--start-date YYYY-MM-DD] [--end-date YYYY-MM-DD] [--json]
Options
--cache-path <path>: Override cache path (defaults to ~/Library/Application Support/Granola/cache-v3.json)
--timezone <IANA-tz>: Override output timezone (defaults to local system timezone)
--no-panels: Disable fallback extraction from documentPanels
--json: Return machine-readable JSON instead of formatted text
Notes
- This script provides:
search_meetings
get_meeting_details
get_meeting_transcript
get_meeting_documents
analyze_meeting_patterns
- No external API calls are made; all processing is local and read-only.