Granola CLI

                                       _
                             _        | |
  __ _ _ __ __ _ _ __   ___ | | __ _  | |
 / _` | '__/ _` | '_ \ / _ \| |/ _` | | |
| (_| | | | (_| | | | | (_) | | (_| | | |
 \__, |_|  \__,_|_| |_|\___/|_|\__,_| | |
 |___/                                |_|

Export your Granola notes and transcripts to local files for backup, migration, or offline access.

Why Use This?

📝 Own Your Data - Keep local copies of all your meeting notes
🎙️ Full Transcripts - Export complete, timestamped transcripts of your meetings
💾 Backup & Migration - Safeguard your notes or move them to other tools
🔄 Smart Updates - Only exports new or changed content
⚡ Fast & Simple - One command to export everything

Installation

Download Pre-Built Binary (Recommended)

Go to the releases page
Download the appropriate file for your operating system:
- macOS: granola_Darwin_x86_64.tar.gz (Intel) or granola_Darwin_arm64.tar.gz (Apple Silicon)
- Linux: granola_Linux_x86_64.tar.gz
- Windows: granola_Windows_x86_64.zip
Extract the archive and move granola to a location in your PATH

Install with Go

If you have Go installed:

go install github.com/theantichris/granola@latest

Quick Start

Export Your Notes

Your notes are the AI-generated summaries and formatted content from Granola.

macOS/Linux:

granola notes --supabase "$HOME/Library/Application Support/Granola/supabase.json"

Windows (PowerShell):

granola notes --supabase "$env:APPDATA\Granola\supabase.json"

Notes will be exported to a notes/ directory as Markdown files.

Export Your Transcripts

Transcripts are the raw, timestamped recordings of everything said in your meetings.

Note: Transcripts are only available for meetings where you enabled audio recording.

macOS:

granola transcripts

Linux:

granola transcripts --cache "$HOME/.config/Granola/cache-v3.json"

Windows (PowerShell):

granola transcripts --cache "$env:APPDATA\Granola\cache-v3.json"

Transcripts will be exported to a transcripts/ directory as text files.

Where Granola Stores Your Data

Supabase Credentials File

Granola uses a supabase.json file for API authentication:

macOS: ~/Library/Application Support/Granola/supabase.json
Linux: ~/.config/Granola/supabase.json or ~/.local/share/Granola/supabase.json
Windows: %APPDATA%\Granola\supabase.json

Cache File (for Transcripts)

Granola stores raw transcripts in a local cache file:

macOS: ~/Library/Application Support/Granola/cache-v3.json
Linux: ~/.config/Granola/cache-v3.json or ~/.local/share/Granola/cache-v3.json
Windows: %APPDATA%\Granola\cache-v3.json

Common Options

Custom Output Directory

# Export notes to a specific location
granola notes --output ~/Documents/MyNotes

# Export transcripts to a specific location
granola transcripts --output ~/Documents/MyTranscripts

Set Default Configuration

Create a .granola.toml file in your home directory to avoid specifying paths every time:

# Notes configuration
supabase = "/Users/yourname/Library/Application Support/Granola/supabase.json"
output = "/Users/yourname/Documents/Notes"

# Transcripts configuration
cache-file = "/Users/yourname/Library/Application Support/Granola/cache-v3.json"
transcript-output = "/Users/yourname/Documents/Transcripts"

Then simply run:

granola notes
granola transcripts

Enable Debug Logging

granola notes --debug
granola transcripts --debug

What Gets Exported

Notes (Markdown Files)

Each note becomes a separate .md file with:

YAML frontmatter - ID, timestamps, tags
Title - As a top-level heading
Content - Formatted as Markdown with headings, lists, etc.

Example:

---
id: abc-123
created: "2024-01-01T00:00:00Z"
updated: "2024-01-02T00:00:00Z"
tags:
  - work
  - planning
---

# Meeting Notes

## Key Points

- First important point
- Second important point

Transcripts (Text Files)

Each transcript becomes a .txt file with:

Header - Title, ID, timestamps, segment count
Timestamped dialogue - [HH:MM:SS] Speaker: Text
Speaker labels - "System" (others) or "You" (your microphone)

Example:

================================================================================
🤖 Team Sync Meeting
ID: abc-123
Created: 2024-01-01T14:00:00.000Z
Segments: 142
================================================================================

[14:00:04] System: Good morning everyone, how's it going?
[14:00:06] You: Good morning! Ready to start.

Troubleshooting

"Failed to read supabase file"

Make sure Granola is installed and you've logged in at least once
Check that the path to supabase.json is correct for your OS
Try running Granola app first, then export

"No transcripts found"

Transcripts are only available for meetings where audio recording was enabled
Check that the cache file path is correct
Make sure you've had at least one meeting with recording enabled

"Permission denied"

Make sure you have read access to the Granola files
Try running without sudo - it's not needed

Need More Help?

Check the --help output: granola notes --help
Open an issue on GitHub

For Contributors & Developers

The sections below are for those who want to contribute to the project or build from source.

Building from Source

Requirements:

Go 1.23.1 or higher
Git

Clone and build:

git clone https://github.com/theantichris/granola.git
cd granola
go build -o granola

Cross-platform builds:

# Linux
GOOS=linux GOARCH=amd64 go build -o granola-linux

# macOS Intel
GOOS=darwin GOARCH=amd64 go build -o granola-darwin

# macOS Apple Silicon
GOOS=darwin GOARCH=arm64 go build -o granola-darwin-arm64

# Windows
GOOS=windows GOARCH=amd64 go build -o granola.exe

Project Structure

granola/
├── cmd/                # Command implementations
│   ├── root.go         # Root command and configuration
│   ├── notes.go        # Notes export (API-based)
│   └── transcripts.go  # Transcripts export (cache-based)
├── internal/           # Internal packages
│   ├── api/            # Granola API client
│   ├── cache/          # Cache file reader
│   ├── converter/      # Document to Markdown converter
│   ├── prosemirror/    # ProseMirror JSON parser
│   ├── transcript/     # Transcript formatter
│   └── writer/         # File system operations
├── main.go             # Entry point
├── README.md           # This file
├── CLAUDE.md           # AI assistant guidelines
├── SPEC.md             # Technical specification
└── LICENSE             # MIT License

Development Commands

# Run tests
go test ./...

# Run tests with coverage
go test -cover ./...

# Run linter (requires golangci-lint)
golangci-lint run

# Run markdown linter (requires markdownlint-cli2)
markdownlint-cli2 "**/*.md" "#notes" "#transcripts"

# Run the CLI without building
go run main.go notes --help

Testing

The project uses Go's standard testing framework with:

Unit tests for individual components
Table-driven tests for comprehensive coverage
Afero for filesystem abstraction in tests
Parallel test execution where possible

Run tests:

go test ./...           # All tests
go test -v ./...        # Verbose output
go test -cover ./...    # With coverage

Releasing

Releases are automated using GoReleaser:

# Create and push a new tag
git tag v1.0.0
git push origin v1.0.0

# GitHub Actions will automatically build and publish the release

For local testing:

goreleaser release --snapshot --clean

Contributing

Contributions are welcome! Here's how to help:

Fork the repository
Create a branch for your feature (git checkout -b feature/amazing-feature)
Write tests for your changes
Ensure tests pass (go test ./...)
Commit your changes (git commit -m 'Add amazing feature')
Push to your branch (git push origin feature/amazing-feature)
Open a Pull Request

Guidelines:

Follow existing code style
Add tests for new functionality
Update documentation as needed
Keep PRs focused on a single change

For more details, see CLAUDE.md (AI development guidelines) and SPEC.md (technical specification).

Key Dependencies

Cobra - CLI framework
Viper - Configuration management
Charmbracelet Log - Structured logging
Afero - Fi

Granola

Install / Use

README