Troubleshoot common Granola errors and issues. Use when experiencing recording problems, sync issues, transcription errors, or integration failures. Trigger with phrases like "granola error", "granola not working", "granola problem", "fix granola", "granola troubleshoot".
npxskills add jeremylongshore/claude-code-plugins-plus-skills--skill granola-common-errorsLoading…
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.
# 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"
Root cause: Granola cannot hear system audio. On macOS, this is almost always a permissions issue.
macOS fix:
# Nuclear option — reset Core Audio if devices are confused
sudo killall coreaudiod
# coreaudiod restarts automatically
Windows fix:
Root cause: Granola stops transcription when it detects no new audio for ~15 minutes, or when the computer sleeps.
Fix:
| Cause | Fix |
|---|---|
| Background noise | Use noise-cancelling headset or quiet room |
| Echo/reverb | Smaller room, soft furnishings |
| Crosstalk (multiple speakers) | One person speaks at a time |
| Low mic volume | Position mic within 12 inches, check input levels |
| Non-English accents | Granola accuracy varies — speak clearly, slower |
Symptoms: Granola doesn't show the floating notepad when you join a call.
Checklist:
Fix:
/invite @Granola# Force quit and restart
pkill -9 Granola
open -a Granola
# Clear caches if crashes persist
rm -rf ~/Library/Caches/Granola
# 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
| Symptom | Most Likely Cause | First Fix |
|---|---|---|
| No transcript | Missing Screen & System Audio permission | Grant permission, restart Granola |
| Transcript stops mid-meeting | Computer sleep or Bluetooth dropout | Keep awake, try wired audio |
| Meeting not detected | No video link in calendar event | Add conferencing link or manually start |
| Slack post missing | Bot not in channel | /invite @Granola |
| HubSpot sync fails | Contact doesn't exist | Create contact in HubSpot first |
| App crashes | Corrupted cache | Delete ~/Library/Caches/Granola |
Proceed to granola-debug-bundle for creating comprehensive diagnostic reports.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).