dennisonbertram/granola-download/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

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.