Agent skill

Granola Common Errors

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Troubleshoot common Granola errors — audio capture failures, transcription issues, calendar sync problems, and integration errors.

MITAuto-check: notesMedia & Creative

Install Granola Common Errors

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill granola-common-errors -a claude-code

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

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace granola-common-errors --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/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/granola-common-errors .claude/skills/granola-common-errors && 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-common-errors
GitHub stars
2.8k
Token cost
~1.9k tokens
SKILL.md length
802 words
Files
2 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Troubleshoot common Granola errors — audio capture failures, transcription issues, calendar sync problems, and integration errors.

  • Works in 2 steps: Quick Diagnostic Check → Match Your Symptom
  • Tasks that involve Transcription
  • SKILL.md covers Overview, Prerequisites, Instructions and Audio / Transcription Issues, plus 9 more sections
  • Calls brew

What it does

Granola Common Errors is an agent skill from jeremylongshore/tons-of-skills-marketplace. Troubleshoot common Granola errors — audio capture failures, transcription issues, calendar sync problems, and integration errors. Platform-specific fixes for macOS and Windows. Trigger: "granola error", "granola not working", "granola not recording", "fix granola", "granola troubleshoot".

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/detailed-errors.md`). Compatibility notes: Designed for Claude Code

It sits in Media & Creative, covering Transcription. It works with macOS. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Tasks that involve Transcription

Example prompts

  • “granola error”
  • “granola not working”
  • “granola not recording”
  • “/granola-common-errors”

Requirements

  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash(pgrep:*), Bash(ps:*), Bash(system_profiler:*), Bash(defaults:*)

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Quick Diagnostic Check
  2. Match Your Symptom

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash(pgrep:*)
    • Bash(ps:*)
    • Bash(system_profiler:*)
    • Bash(defaults:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • brew

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

  • Network

    Links to these hosts (documentation or services it may open):

    • status.granola.ai
    • docs.granola.ai
    • granola.ai

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Granola Common Errors loads about 1.9k tokens when it runs, and up to ~2.5k if it reads all its reference files. Until then it costs about 78 tokens; SKILL.md has 802 words of instructions outside code blocks.

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

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.

  • NoteRuns commands with sudoSKILL.md:64
    sudo killall coreaudiod

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 802 words, ~1,921 tokens.

Download SKILL.mdSave it as .claude/skills/granola-common-errors/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
granola-common-errors
description
Troubleshoot common Granola errors — audio capture failures, transcription issues, calendar sync problems, and integration errors. Platform-specific fixes for macOS and Windows. Trigger: "granola error", "granola not working", "granola not recording", "fix granola", "granola troubleshoot".
allowed-tools
Read, Write, Edit, Bash(pgrep:*), Bash(ps:*), Bash(system_profiler:*), Bash(defaults:*)
compatibility
Designed for Claude Code
version
1.13.0
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, granola, troubleshooting

Granola Common Errors

Overview

Diagnose and fix the most common Granola issues. Each error includes platform-specific symptoms, root causes, and step-by-step remediation. Granola captures audio from your device's system audio output (not via meeting platform APIs), so most issues trace back to audio permissions or device configuration.

Prerequisites

  • Granola installed (even if malfunctioning)
  • Terminal access for diagnostic commands (macOS) or PowerShell (Windows)
  • Admin/sudo access for permission changes

Instructions

Step 1 — Quick Diagnostic Check
bash
# Is Granola running?
pgrep -l Granola

# What version?
defaults read /Applications/Granola.app/Contents/Info.plist CFBundleShortVersionString 2>/dev/null

# Audio devices available
system_profiler SPAudioDataType 2>/dev/null | grep -A2 "Default Input"
Step 2 — Match Your Symptom

Audio / Transcription Issues

"No Audio Captured" — Transcript is Empty

Root cause: Granola cannot hear system audio. On macOS, this is almost always a permissions issue.

macOS fix:

  1. System Settings > Privacy & Security > Screen & System Audio Recording
  2. Enable Granola (this grants system audio access despite the misleading name)
  3. System Settings > Privacy & Security > Microphone > Enable Granola
  4. Restart Granola after changing permissions (right-click menu bar icon > Restart)
bash
# Nuclear option — reset Core Audio if devices are confused
sudo killall coreaudiod
# coreaudiod restarts automatically

Windows fix:

  1. Settings > Privacy & Security > Microphone > Ensure Granola is enabled
  2. Check that the correct audio device is set as default output
  3. Right-click sound icon > Sound settings > ensure no audio enhancements are enabled
"Transcription Starts Then Stops" (4-5 Minutes In)

Root cause: Granola stops transcription when it detects no new audio for ~15 minutes, or when the computer sleeps.

Fix:

  • Keep your machine awake during meetings (disable sleep/screen lock)
  • Ensure meeting audio is playing through your default output device
  • Bluetooth devices can cause dropouts — try built-in speakers or wired headset
  • Right-click Granola icon > Restart Granola, then reopen the note
"Poor Transcription Quality"
CauseFix
Background noiseUse noise-cancelling headset or quiet room
Echo/reverbSmaller room, soft furnishings
Crosstalk (multiple speakers)One person speaks at a time
Low mic volumePosition mic within 12 inches, check input levels
Non-English accentsGranola accuracy varies — speak clearly, slower

Calendar / Meeting Detection Issues

"Meeting Not Detected"

Symptoms: Granola doesn't show the floating notepad when you join a call.

Checklist:

  1. Calendar connected? Settings > Calendar — reconnect if expired
  2. Event has video link? Granola only detects events with Zoom/Meet/Teams/WebEx links
  3. Right calendar synced? Check that the meeting's calendar is in the sync list
  4. Force refresh: Click the sync icon in Granola, wait 30 seconds
  5. Manual start: Click Granola menu bar icon > Start Recording to bypass detection
"Calendar Authentication Failed"

Fix:

  1. Settings > Calendar > Disconnect
  2. Clear browser cookies for accounts.google.com or login.microsoftonline.com
  3. Reconnect calendar in a private/incognito browser window
  4. If using Google Workspace with admin restrictions, IT may need to approve Granola's OAuth app

Integration Errors

Slack — "Channel Not Found" or Post Fails
  1. Verify the channel exists and hasn't been renamed
  2. Invite the Granola bot to the channel: /invite @Granola
  3. Reconnect Slack at Settings > Integrations > Slack
Notion — "Database Missing" or Share Fails
  1. Granola creates its own database on first connect — don't delete it
  2. Reconnect Notion: Settings > Integrations > Notion > Disconnect > Reconnect
  3. Granola can only write to its own database (you cannot pick a custom database)
Show full SKILL.md (315 more words)Show less
HubSpot — "Contact Not Matched"
  1. The attendee's email must match a HubSpot Contact record
  2. Granola does not create new contacts automatically
  3. Create the contact in HubSpot first, then re-share the note
  4. For auto-creation, use Zapier with a "Find or Create Contact" action
Zapier — "Trigger Not Firing"
  1. Verify Granola connection in Zapier (reconnect if needed)
  2. Check that the folder name in the trigger matches exactly
  3. For "Note Added to Folder" trigger, ensure the note is actually in that folder
  4. Add a 2-minute delay step — notes may still be processing when the trigger fires

App Issues

App Crashes or Freezes
bash
# Force quit and restart
pkill -9 Granola
open -a Granola

# Clear caches if crashes persist
rm -rf ~/Library/Caches/Granola
App Won't Start After Update
bash
# Clear preferences (you'll need to re-authenticate)
defaults delete ai.granola.app 2>/dev/null
rm -rf ~/Library/Caches/Granola

# Reinstall
brew reinstall --cask granola
"Processing Stuck" — Notes Never Finish
  • Normal processing takes 1-2 minutes per meeting
  • Wait up to 15 minutes for long meetings (2+ hours)
  • Check internet connectivity
  • Check status.granola.ai for service outages
  • Restart Granola and reopen the note

Output

  • Root cause identified for the specific Granola issue
  • Platform-specific fix applied and verified
  • Meeting capture confirmed working after remediation

Error Quick Reference

SymptomMost Likely CauseFirst Fix
No transcriptMissing Screen & System Audio permissionGrant permission, restart Granola
Transcript stops mid-meetingComputer sleep or Bluetooth dropoutKeep awake, try wired audio
Meeting not detectedNo video link in calendar eventAdd conferencing link or manually start
Slack post missingBot not in channel/invite @Granola
HubSpot sync failsContact doesn't existCreate contact in HubSpot first
App crashesCorrupted cacheDelete ~/Library/Caches/Granola

Error Handling

Stop on unknown calendar/account scope, failed redaction, unapproved destination, repeated non-idempotent task creation, or an error bundle containing meeting content. Capture only status, aggregate counts, and opaque correlation IDs; restore the prior configuration rather than widening access or retries.

Examples

status=429; env=sandbox; correlation=req-opaque-11; action=bounded-backoff; meeting_payload=excluded; synthetic_probe=recovered supports a privacy-safe handoff.

Resources

Next Steps

Proceed to granola-debug-bundle for creating comprehensive diagnostic reports.

© jeremylongshore, 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 1 other file (references) in skills/.curated/granola-common-errors of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/detailed-errors.md

Open the folder on GitHubat commit cfae287

Compare with similar skills

Granola Common Errors 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 Common Errors compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Granola Common Errors this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.9kAutomated safety check: NotesMIT
Voxtype Installpchalasani/claude-code-tools2k—~857Automated safety check: NotesMIT
Setup Macbook Productivityaiskillstore/marketplace433—~711Automated safety check: PassNone
Open Editveedstudio/open-edit1.6k—~1.8kAutomated safety check: PassApache-2.0
Transcribebadlogic/pi-skills2.6k—~264Automated safety check: PassMIT
C Voicedaxaur/openpaw173—~401Automated safety check: PassMIT

Similar skills

  • Voxtype Install

    pchalasani/claude-code-tools

    Guide the user through installing, configuring, and launching voxtype — local on-device voice dictation (speech-to-text that types wherever the cursor is).

    2k GitHub stars~857 tokensUpdated yesterday
    Media & CreativeAuto-check: notes
  • Setup Macbook Productivity

    aiskillstore/marketplace

    Configure repeatable macOS productivity settings on a user's MacBook, especially voice typing / Dictation setup.

    433 GitHub stars~711 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Open Edit

    veedstudio/open-edit

    Video work with VEED's hosted services and a CLI toolkit — word-timed transcription, cutting, background removal, AI presenters, lipsync, any fal model, sound mixing, and a Chrome renderer for HTML…

    1.6k GitHub stars~1.8k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • Transcribe

    badlogic/pi-skills

    Local speech-to-text transcription on Apple Silicon macOS. An agent skill from badlogic/pi-skills.

    2.6k GitHub stars~264 tokensUpdated 4 mo ago
    Media & CreativeAuto-check passed
  • C Voice

    daxaur/openpaw

    Convert speech to text using sag (ElevenLabs STT) and synthesize speech using say (macOS built-in TTS).

    173 GitHub stars~401 tokensUpdated 4 mo ago
    Media & CreativeAuto-check passed
  • Video Clipping Reference

    RightNow-AI/openfang

    Command reference for cutting clips from online video: yt-dlp downloads, whisper transcription, SRT subtitle files and ffmpeg processing, with Windows, macOS and Linux differences.

    18k GitHub stars~4.1k tokensUpdated 3 mo ago
    Media & CreativeAuto-check: warnings

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated yesterday
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated yesterday
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed

Works with

Questions about Granola Common Errors

What does Granola Common Errors do?

Troubleshoot common Granola errors — audio capture failures, transcription issues, calendar sync problems, and integration errors. Granola Common Errors is an agent skill from jeremylongshore/tons-of-skills-marketplace. Troubleshoot common Granola errors — audio capture failures, transcription issues, calendar sync problems, and integration errors.

When should I use Granola Common Errors?

Granola Common Errors fits situations like: tasks that involve Transcription.

How do I install Granola Common Errors in Claude Code?

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

How do I install Granola Common Errors in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill granola-common-errors -a codex`. Or copy the skill folder (skills/.curated/granola-common-errors in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/granola-common-errors in your project. Codex loads it when a task matches its description.

Can I use Granola Common Errors 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 jeremylongshore/tons-of-skills-marketplace --skill granola-common-errors -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-common-errors, .gemini/skills/granola-common-errors, .github/skills/granola-common-errors and .opencode/skills/granola-common-errors in your project.

What does Granola Common Errors need to run?

Going by SKILL.md and its folder, Granola Common Errors needs the command-line tools its instructions call (brew). Its frontmatter pre-approves these tools: Read, Write, Edit, Bash(pgrep:*), Bash(ps:*), Bash(system_profiler:*), Bash(defaults:*). Compatibility (from SKILL.md): Designed for Claude Code.

Does Granola Common Errors access the network?

SKILL.md names 3 domains. As links in the text: status.granola.ai, docs.granola.ai and granola.ai. This is read from the text; nothing was executed.

Is Granola Common Errors safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Granola Common Errors use?

Granola Common Errors is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Granola Common Errors use?

About 1.9k tokens (SKILL.md is roughly 7.7k 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 567 tokens, read only when the agent opens those files.

What are the alternatives to Granola Common Errors?

Skills that share tags, products or a category with Granola Common Errors: Voxtype Install (pchalasani/claude-code-tools, 2k stars), Setup Macbook Productivity (aiskillstore/marketplace, 433 stars), Open Edit (veedstudio/open-edit, 1.6k stars) and Transcribe (badlogic/pi-skills, 2.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Granola Common Errors?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

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