granola

Granola

Back up your Granola meeting transcripts to local disk and query them. Granola encrypts its local storage and uses single-use auth tokens that rotate on every refresh, so the key trick is: always re-extract a fresh token from the live app immediately before downloading. The bundled pull.py pipeline does this for you.

Requires the Granola desktop app installed and logged in (the token is decrypted from its local keychain entry). macOS only.

Usage

/granola              # pull latest (refresh token → download new → rename)
/granola search XYZ   # full-text search across transcript bodies
/granola get <id|title|date>   # print one transcript
/granola stats        # archive location + counts

Trigger phrases: "pull granola", "sync granola", "download my transcripts", "back up my meetings", "search my transcripts", "find that meeting about …", "refresh granola token".

Step 0 — Locate or install the toolkit (do this first, every run)

The skill needs the Granola-Download repo (scripts + venv). Find an existing checkout or install one to a stable location. Run this bootstrap; $GRANOLA is the repo path for all later steps:

set -e
GRANOLA=""
for d in "$HOME/develop/Granola-Download" "$HOME/Granola-Download" \
         "$HOME/.local/share/granola-download"; do
  [ -f "$d/pull.py" ] && GRANOLA="$d" && break
done
if [ -z "$GRANOLA" ]; then
  GRANOLA="$HOME/.local/share/granola-download"
  git clone https://github.com/dennisonbertram/Granola-Download "$GRANOLA"
fi
# Ensure the venv + deps exist (idempotent).
if [ ! -x "$GRANOLA/.venv/bin/python" ]; then
  python3 -m venv "$GRANOLA/.venv"
fi
"$GRANOLA/.venv/bin/python" -m pip install -q -r "$GRANOLA/requirements.txt"
echo "GRANOLA=$GRANOLA"

Use $GRANOLA/.venv/bin/python as the interpreter for every command below.

Step 1 — Pull (default action)

"$GRANOLA/.venv/bin/python" "$GRANOLA/pull.py"

Re-extracts a fresh token, then downloads only new documents (skips already-downloaded by document_id).
Renames new folders to YYYY-MM-DD_HHMM_Subject_<id8> (local time, sorts chronologically). Idempotent.
Output lands in $GRANOLA/transcripts_output/.

If a pull fails with a 400 / "Failed to obtain access token": the saved token went stale (it rotates, single-use). pull.py already re-extracts before downloading, so just run it again. If extraction itself fails, confirm the Granola desktop app is installed and logged in.

Step 2 — Search / read the archive

Prefer the granola MCP server tools if present in this session (mcp__granola__search_transcripts, __list_meetings, __get_transcript, __sync, __archive_stats). Otherwise use the bundled stdlib reader:

"$GRANOLA/.venv/bin/python" - "$GRANOLA" <<'PY'
import sys; root = sys.argv[1]; sys.path.insert(0, f"{root}/granola")
import archive
out = f"{root}/transcripts_output"
# search bodies:
for r in archive.search_transcripts("QUERY", output_dir=out, limit=10):
    print(r["date"], "|", r["title"], "| hits", r["match_count"], "\n   ", r["snippet"])
# list by date/title:  archive.list_meetings(output_dir=out, since="2026-01-01", query="weekly")
# read one:            print(archive.get_transcript("ID-OR-TITLE", output_dir=out)["content"])
PY

Step 3 — Credentials (handle internally, never print)

Refreshing the token just means running pull.py (or extract_config.py, which rewrites config.json). Never echo config.json, the access token, or the refresh token into the conversation — they are live credentials. If the user explicitly wants to see them, confirm first and point them at the gitignored config.json.

Reference

File	Purpose
`pull.py`	One-command pipeline: extract token → download → rename
`extract_config.py`	Decrypt Granola storage → fresh `config.json` (token + client_id)
`granola/download_transcripts.py`	Transcript-only download (`main.py` = full export incl. AI notes)
`granola/rename_folders.py`	Idempotent readable-name renamer
`granola/archive.py`	Stdlib reader: `list_meetings` / `search_transcripts` / `get_transcript` / `stats`
`mcp_server/server.py`	Local stdio MCP server exposing the above

Guardrails

config.json, transcripts_output/, and .venv/ are gitignored — never commit them or paste their contents.
The token rotates constantly; don't cache it. Re-run pull.py.
Full export (AI summaries + workspace/folder metadata): "$GRANOLA/.venv/bin/python" "$GRANOLA/granola/main.py" ./my-export.