How do I install the Granola skill?

Run npx skillmds@latest add glebis/granola in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Granola safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Granola?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Granola free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Granola?

glebis (@glebis) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Granola by glebis — Agent Skill

Name: Granola
Rating: 4.2 (5 reviews)
Author: glebis

Granola

This skill should be used when importing, listing, or exporting Granola meeting recordings and transcripts. Queries Granola's Personal API to list meetings, extract transcripts, and export to Obsidian notes in Fathom-compatible format.

glebis ad4198f 16 files · 26.4 KB Updated Sep 9, 2026

File contents

Granola Meeting Importer

Query Granola via Personal API to list notes, view transcripts, and export to Obsidian vault in the same format as the Fathom skill.

Prerequisites

Granola Business or Enterprise plan (Personal API required)
API key in sops-encrypted ~/Brains/brain/.env.granola as GRANOLA_API_KEY=grn_...
No additional dependencies (uses stdlib only)

Usage

python3 ~/.claude/skills/granola/scripts/granola.py <command> [options]

Commands

Command	Description
`list`	List notes from Personal API
`show <note_id>`	Show note details (summary, attendees, optionally transcript)
`export <note_id>`	Export note to Obsidian markdown (Fathom-compatible format)

Options

Option	Applies to	Description
`--format text\|json`	list, show	Output format (default: text)
`--after <ISO date>`	list	Filter notes created after date
`--all`	list	Paginate through all results
`--transcript`	show	Include transcript in output
`--vault <path>`	export	Obsidian vault path (default: ~/Brains/brain)
`--output <path>`	export	Custom output file path

Examples

List recent meetings

python3 ~/.claude/skills/granola/scripts/granola.py list
python3 ~/.claude/skills/granola/scripts/granola.py list --format json
python3 ~/.claude/skills/granola/scripts/granola.py list --after 2026-05-01

Show note with transcript

python3 ~/.claude/skills/granola/scripts/granola.py show not_5FkswTp4Omkpm5
python3 ~/.claude/skills/granola/scripts/granola.py show not_5FkswTp4Omkpm5 --transcript --format json

Export to Obsidian

python3 ~/.claude/skills/granola/scripts/granola.py export not_5FkswTp4Omkpm5
python3 ~/.claude/skills/granola/scripts/granola.py export not_5FkswTp4Omkpm5 --vault ~/Brains/brain

Output Format

Exported notes match Fathom skill format for consistency:

---
granola_id: not_xxxx
title: "Meeting Title"
date: YYYY-MM-DD
participants: ['Name 1', 'Name 2']
duration: HH:MM
source: granola
---

# Meeting Title

## Summary
{AI-generated summary}

## Transcript
**Speaker Name**: What they said...

Files saved as: Sessions/YYYYMMDD-meeting-title-slug.md

API Details

Base URL: https://public-api.granola.ai/v1
Auth: Bearer token (Personal API key, never expires)
Rate limits: 25 req burst / 5 req/sec sustained
Important: API only returns notes with generated summaries — in-progress meetings won't appear

Known Limitations

No live/in-progress access — notes appear only after Granola generates the AI summary
No per-utterance speaker names — Granola provides source (microphone vs speaker) and optional diarization_label. Export assigns meeting owner to microphone utterances
Note IDs required — use list first to get not_xxxx IDs, then show/export

Integration

transcript-analyzer: After export, run transcript-analyzer on the output file for deeper analysis
Fathom skill: Granola exports use the same frontmatter and transcript format as Fathom exports, so downstream tools work with both

---name: granoladescription: This skill should be used when importing, listing, or exporting Granola meeting recordings and transcripts. Queries Granola's Personal API to list meetings, extract transcripts, and export to Obsidian notes in Fathom-compatible format.--- # Granola Meeting Importer Query Granola via Personal API to list notes, view transcripts, and export to Obsidian vault in the same format as the Fathom skill. ## Prerequisites - Granola Business or Enterprise plan (Personal API required) - API key in sops-encrypted `~/Brains/brain/.env.granola` as `GRANOLA_API_KEY=grn_...` - No additional dependencies (uses stdlib only) ## Usage ```bash python3 ~/.claude/skills/granola/scripts/granola.py <command> [options] ``` ### Commands | Command | Description | |---------|-------------| | `list` | List notes from Personal API | | `show <note_id>` | Show note details (summary, attendees, optionally transcript) | | `export <note_id>` | Export note to Obsidian markdown (Fathom-compatible format) | ### Options | Option | Applies to | Description | |--------|-----------|-------------| | `--format text\|json` | list, show | Output format (default: text) | | `--after <ISO date>` | list | Filter notes created after date | | `--all` | list | Paginate through all results | | `--transcript` | show | Include transcript in output | | `--vault <path>` | export | Obsidian vault path (default: ~/Brains/brain) | | `--output <path>` | export | Custom output file path | ## Examples ### List recent meetings ```bash python3 ~/.claude/skills/granola/scripts/granola.py list python3 ~/.claude/skills/granola/scripts/granola.py list --format json python3 ~/.claude/skills/granola/scripts/granola.py list --after 2026-05-01 ``` ### Show note with transcript ```bash python3 ~/.claude/skills/granola/scripts/granola.py show not_5FkswTp4Omkpm5 python3 ~/.claude/skills/granola/scripts/granola.py show not_5FkswTp4Omkpm5 --transcript --format json ``` ### Export to Obsidian ```bash python3 ~/.claude/skills/granola/scripts/granola.py export not_5FkswTp4Omkpm5 python3 ~/.claude/skills/granola/scripts/granola.py export not_5FkswTp4Omkpm5 --vault ~/Brains/brain ``` ## Output Format Exported notes match Fathom skill format for consistency: ```markdown --- granola_id: not_xxxx title: "Meeting Title" date: YYYY-MM-DD participants: ['Name 1', 'Name 2'] duration: HH:MM source: granola --- # Meeting Title ## Summary {AI-generated summary} ## Transcript **Speaker Name**: What they said... ``` Files saved as: `Sessions/YYYYMMDD-meeting-title-slug.md` ## API Details - **Base URL**: `https://public-api.granola.ai/v1` - **Auth**: Bearer token (Personal API key, never expires) - **Rate limits**: 25 req burst / 5 req/sec sustained - **Important**: API only returns notes with generated summaries — in-progress meetings won't appear ## Known Limitations - **No live/in-progress access** — notes appear only after Granola generates the AI summary - **No per-utterance speaker names** — Granola provides `source` (microphone vs speaker) and optional `diarization_label`. Export assigns meeting owner to microphone utterances - **Note IDs required** — use `list` first to get `not_xxxx` IDs, then `show`/`export` ## Integration - **transcript-analyzer**: After export, run transcript-analyzer on the output file for deeper analysis - **Fathom skill**: Granola exports use the same frontmatter and transcript format as Fathom exports, so downstream tools work with both

Frequently asked questions