Agent skill

Granola

by glebis in glebis/claude-skills

This skill should be used when importing, listing, or exporting Granola meeting recordings and transcripts.

MITAuto-check: notesKnowledge Management

Install Granola

skills CLI
$ npx skills add glebis/claude-skills --skill granola -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install glebis/claude-skills granola --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/glebis/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/granola .claude/skills/granola && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
granola
GitHub stars
391
Token cost
~874 tokens
SKILL.md length
262 words
Files
16 (incl. scripts, references)
Skills in repo
92
Repo updated
First seen
Licence
MIT

At a glance

This skill should be used when importing, listing, or exporting Granola meeting recordings and transcripts.

  • Tasks that involve Note-taking
  • SKILL.md covers Prerequisites, Usage, Examples and Output Format, plus 3 more sections
  • Runs Python and Shell scripts from its folder; calls python3; reaches public-api.granola.ai; needs GRANOLA_API_KEY

What it does

Granola is an agent skill from glebis/claude-skills. 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.

Its SKILL.md is about 870 tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including scripts and reference files (for example `.claude-plugin/plugin.json`, `references/cache-structure.md` and `scripts/granola.py`).

It sits in Knowledge Management, covering Note-taking. It works with Obsidian. The repository describes itself as: Collection of Claude Code skills for enhanced AI workflows. The licence is MIT.

When your agent uses it

  • Tasks that involve Note-taking

Example prompts

  • “/granola”

Requirements

  • Python 3
  • A Bash shell
  • A credential in GRANOLA_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 3b88261. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 13 files in scripts/ (Python and Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • public-api.granola.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GRANOLA_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Granola loads about 874 tokens when it runs, and up to ~1.4k if it reads all its reference files. Until then it costs about 61 tokens; SKILL.md has 262 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~874
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:13
    PI key in sops-encrypted `~/Brains/brain/.env.granola` as `GRANOLA_API_KEY=grn_...`

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from glebis/claude-skills at commit 3b88261, republished under its MIT licence (© glebis). 262 words, ~874 tokens.

Download SKILL.mdSave it as .claude/skills/granola/SKILL.md (or your agent's skills folder). This skill also uses 15 other files; get the full folder from GitHub.
name
granola
description
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
CommandDescription
listList 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
OptionApplies toDescription
--format text|jsonlist, showOutput format (default: text)
--after <ISO date>listFilter notes created after date
--alllistPaginate through all results
--transcriptshowInclude transcript in output
--vault <path>exportObsidian vault path (default: ~/Brains/brain)
--output <path>exportCustom 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

© glebis, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 15 other files (scripts, references) in granola of glebis/claude-skills.

  • SKILL.md
  • .claude-plugin/plugin.json
  • references/cache-structure.md
  • scripts/granola.py
  • scripts/sync.sh
  • scripts/tests/__init__.py
  • scripts/tests/fixtures/cache_object_state.json
  • scripts/tests/fixtures/cache_string_state.json
  • scripts/tests/test_cmd_export.py
  • scripts/tests/test_cmd_list.py
  • scripts/tests/test_cmd_show.py
  • scripts/tests/test_compute_duration.py
  • scripts/tests/test_extract_calendar_times.py
  • scripts/tests/test_extract_people.py
  • scripts/tests/test_format_time.py
  • scripts/tests/test_load_cache.py

Open the folder on GitHubat commit 3b88261

Compare with similar skills

Granola next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Granola compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Granola this skillglebis/claude-skills391—~874Automated safety check: NotesMIT
Obsidian Knowledge BuilderMichael-OvO/obsidian-knowledge-agent205—~917Automated safety check: PassMIT
Obsidian Canvas BoardsAgriciDaniel/claude-obsidian15k—~1.4kAutomated safety check: PassMIT
LLM Wikilewislulu/llm-wiki-skill655—~3.7kAutomated safety check: PassNone
Obsidian Bases EditorAgriciDaniel/claude-obsidian15k—~1.2kAutomated safety check: PassMIT
My LLM WikiMartinLwx/dotfiles140—~2.7kAutomated safety check: PassNone

Similar skills

  • Obsidian Knowledge Builder

    Michael-OvO/obsidian-knowledge-agent

    Turns PDFs, slides, syllabi, papers and transcripts into structured, teaching-quality Obsidian notes, matching how much structure is built to how much the material needs.

    205 GitHub stars~917 tokensUpdated 3 mo ago
    Knowledge ManagementAuto-check passed
  • Obsidian Canvas Boards

    AgriciDaniel/claude-obsidian

    Creates, inspects and updates Obsidian JSON Canvas boards in a vault, with text, file, link, group and edge nodes, using safe recoverable edits.

    15k GitHub stars~1.4k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed
  • LLM Wiki

    lewislulu/llm-wiki-skill

    Build and maintain a Karpathy-style LLM knowledge base — a self-compiling Obsidian markdown wiki where an Agent ingests raw sources, compiles cross-linked concept/entity/summary pages, answers…

    655 GitHub stars~3.7k tokensUpdated 5 mo ago
    Knowledge ManagementAuto-check passed
  • Obsidian Bases Editor

    AgriciDaniel/claude-obsidian

    Explains, drafts and validates Obsidian Bases .base files, building filters, formulas and table, card or list views, and applying edits only through one inspected transaction.

    15k GitHub stars~1.2k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed
  • My LLM Wiki

    MartinLwx/dotfiles

    Provides access to the user's personal wiki, including notes, research, project documentation, decisions, and archived knowledge.

    140 GitHub stars~2.7k tokensUpdated 2 days ago
    Knowledge ManagementAuto-check passed
  • LLM Wiki

    CharlesHoskinson/sevenlayer

    Builds and maintains a persistent, interlinked Obsidian-compatible markdown knowledge wiki in a git repo via three operations — ingest a source into linked pages, answer a question from the…

    116 GitHub stars~1.5k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed

More from glebis/claude-skills

All 92 skills in this repo
  • Runs a human-first workflow for labeling PII spans in a transcript, then scores inter-annotator agreement and drafts an adjudicated gold set.

    391 GitHub stars~1.3k tokensUpdated 2 days ago
    Auto-check passed
  • Automates a dedicated, logged-in Chrome instance per profile without ever closing the user's own open tabs or browser windows.

    391 GitHub stars~973 tokensUpdated 2 days ago
    Auto-check passed
  • Deep Research

    glebis/claude-skills

    This skill should be used when conducting comprehensive research on any topic using the OpenAI Deep Research API.

    391 GitHub stars~2.6k tokensUpdated 2 days ago
    Auto-check: notes
  • Elimination Research

    glebis/claude-skills

    This skill should be used for elimination-style research where the user wants to choose from a shortlist of products, tools, services, vendors, or other options using explicit criteria, numeric…

    391 GitHub stars~1.6k tokensUpdated 2 days ago
    Auto-check passed
  • Narrated HTML Presentations

    glebis/claude-skills

    Generates a self-contained HTML presentation with article and slides modes, ElevenLabs voiceover narration and optional GPT Image 2 illustrations.

    391 GitHub stars~2.3k tokensUpdated 2 days ago
    Auto-check: notes
  • Writes fictional but realistic coaching or therapy session transcripts for evals, demos and few-shot examples, in several modalities and export formats.

    391 GitHub stars~2.9k tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Granola

What does Granola do?

This skill should be used when importing, listing, or exporting Granola meeting recordings and transcripts. Granola is an agent skill from glebis/claude-skills. This skill should be used when importing, listing, or exporting Granola meeting recordings and transcripts.

When should I use Granola?

Granola fits situations like: tasks that involve Note-taking.

How do I install Granola in Claude Code?

Run `npx skills add glebis/claude-skills --skill granola -a claude-code`. Or copy the skill folder (granola in glebis/claude-skills) into .claude/skills/granola in your project. Claude Code loads it when a task matches its description.

How do I install Granola in Codex?

Run `npx skills add glebis/claude-skills --skill granola -a codex`. Or copy the skill folder (granola in glebis/claude-skills) into .agents/skills/granola in your project. Codex loads it when a task matches its description.

Can I use Granola in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add glebis/claude-skills --skill granola -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/granola, .gemini/skills/granola, .github/skills/granola and .opencode/skills/granola in your project.

What does Granola need to run?

Going by SKILL.md and its folder, Granola needs Python and a shell for the scripts in its folder, the command-line tools its instructions call (python3) and credentials named GRANOLA_API_KEY. Our summary lists: Python 3; A Bash shell; A credential in GRANOLA_API_KEY.

Does Granola access the network?

SKILL.md names 1 domain. In commands or code: public-api.granola.ai; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Granola safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Granola use?

Granola is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Granola use?

About 874 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 515 tokens, read only when the agent opens those files.

What are the alternatives to Granola?

Skills that share tags, products or a category with Granola: Obsidian Knowledge Builder (Michael-OvO/obsidian-knowledge-agent, 205 stars), Obsidian Canvas Boards (AgriciDaniel/claude-obsidian, 15k stars), LLM Wiki (lewislulu/llm-wiki-skill, 655 stars) and Obsidian Bases Editor (AgriciDaniel/claude-obsidian, 15k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Granola?

glebis (a GitHub user) maintains it in glebis/claude-skills, which has 391 GitHub stars. The repository holds 92 skills in this directory. The repository was last updated on October 8, 2026.

Source: glebis/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.