---
name: Granola
slug: granola
category: Automation
description: Granola queries local Granola meeting data and syncs transcripts and notes into an Obsidian vault. Use it when you need to list, inspect, or import meeting notes from Granola cache files.
github: "https://github.com/ArtemXTech/claude-code-obsidian-starter/tree/main/.claude/skills/granola"
language: Typst
stars: 224
forks: 46
install: "npx degit https://github.com/ArtemXTech/claude-code-obsidian-starter/tree/main/.claude/skills/granola ~/.claude/skills/granola"
installs_to: ~/.claude/skills/granola
source_path: .claude/skills/granola/SKILL.md
collection_size: 5
category_size: 1754
collection_url: "https://dirskills.com/collections/ArtemXTech/claude-code-obsidian-starter"
added: 2026-09-03T06:05:32.547Z
last_synced: 2026-09-03T06:05:32.547Z
canonical_url: "https://dirskills.com/skills/granola"
---

# Granola

Granola queries local Granola meeting data and syncs transcripts and notes into an Obsidian vault. Use it when you need to list, inspect, or import meeting notes from Granola cache files.

**Install:**

```bash
npx degit https://github.com/ArtemXTech/claude-code-obsidian-starter/tree/main/.claude/skills/granola ~/.claude/skills/granola
```

## README

# Granola Skill

Query and sync Granola AI meeting notes to Obsidian vault.

## How It Works

Granola stores everything locally at `~/Library/Application Support/Granola/cache-v3.json`:
- Documents (meetings with title, notes, people)
- Transcripts (real-time, with timestamps and source)
- Updates in real-time as you record

No API calls needed - reads directly from local cache.

## Quick Start

```bash
# List all meetings
python3 .claude/skills/granola/scripts/granola.py list

# Get specific meeting with transcript
python3 .claude/skills/granola/scripts/granola.py get <id>

# Sync new meetings to vault
python3 .claude/skills/granola/scripts/granola.py sync

# Sync specific meeting
python3 .claude/skills/granola/scripts/granola.py sync --id <id>
```

## Commands

### list

List all Granola meetings with sync status.

```bash
python3 .claude/skills/granola/scripts/granola.py list
python3 .claude/skills/granola/scripts/granola.py list --limit 5
```

Output:
```
[✓] 2026-01-09  Team Sync - Weekly
    ID: abc123...
    Transcript: 450 segments, ~86 min

[ ] 2026-01-10  Team Standup
    ID: def456...
    Transcript: 120 segments, ~15 min
```

- `[✓]` = already synced to vault
- `[ ]` = not synced yet

### get

View full meeting details and transcript.

```bash
python3 .claude/skills/granola/scripts/granola.py get <id>
python3 .claude/skills/granola/scripts/granola.py get <id> --no-transcript
```

### sync

Sync meetings to `Meetings/` as structured Markdown.

```bash
# Sync new meetings only
python3 .claude/skills/granola/scripts/granola.py sync

# Sync specific meeting
python3 .claude/skills/granola/scripts/granola.py sync --id <id>

# Re-sync all (overwrites existing)
python3 .claude/skills/granola/scripts/granola.py sync --all
```

## Output Format

Synced meetings are saved to `Meetings/` with this structure:

```markdown
---
type: granola-meeting
date: 2026-01-09
time: "19:30"
duration_min: 86
granola_id: abc123...
people:
  - "[[Sarah Chen]]"
topics: []
status: raw
---

# Meeting Title

## Notes

(Your notes from Granola)

## Transcript

[19:30:45] 🎤 Hey, how's it going?
[19:30:48] 🎤 Great to meet you...
```

**Transcript icons:**
- 🎤 = microphone (you)
- 🔊 = system audio (others on call)

## Workflow

1. **Record meeting** in Granola (real-time transcription)
2. **Sync to vault**: `python3 .claude/skills/granola/scripts/granola.py sync`
3. **Process meeting**: Extract action items, update people notes
4. **Mark as processed**: Change `status: raw` to `status: processed`

## Querying with Bases

Use `Granola.base` to query synced meetings:

| View | Filter |
|------|--------|
| Recent | Last 7 days |
| Needs Processing | status = raw |
| By Person | Grouped by people field |

## Data Structure

**Local cache:** `~/Library/Application Support/Granola/cache-v3.json`

```
cache (JSON string) → state →
  ├── documents: {id: {title, notes_plain, notes_markdown, people, created_at}}
  └── transcripts: {id: [{text, source, start_timestamp, end_timestamp}]}
```

**Transcript segment:**
```json
{
  "text": "Hey, how's it going?",
  "source": "microphone",
  "start_timestamp": "2026-01-09T19:30:45.123Z",
  "end_timestamp": "2026-01-09T19:30:48.456Z"
}
```

## Tips

- **Real-time access**: Cache updates as you record - can query mid-meeting
- **Free tier hack**: Sync hourly to bypass 7-day history limit
- **No auth needed**: Uses local files, not API