Claude-skill-registry granola-common-errors

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/granola-common-errors" ~/.claude/skills/majiayu000-claude-skill-registry-granola-common-errors && rm -rf "$T"
manifest: skills/data/granola-common-errors/SKILL.md
source content

Granola Common Errors

Overview

Diagnose and resolve common Granola issues for uninterrupted meeting capture.

Quick Diagnostics

Check Granola Status

# macOS - Check if Granola is running
pgrep -l Granola

# Check audio devices
system_profiler SPAudioDataType | grep "Default Input"

# Check microphone permissions
tccutil list | grep Granola

Common Errors & Solutions

Audio Issues

Error: "No Audio Captured"

Symptoms: Meeting recorded but transcript is empty Causes & Solutions:

CauseSolution
Wrong audio inputSystem Preferences > Sound > Input > Select correct device
Microphone mutedCheck physical mute button on device
Permission deniedGrant microphone access in System Preferences
Virtual audio conflictDisable conflicting audio software
# Reset audio on macOS
sudo killall coreaudiod

Error: "Poor Transcription Quality"

Symptoms: Many errors in transcript Solutions:

  1. Use quality microphone or headset
  2. Reduce background noise
  3. Speak clearly and at moderate pace
  4. Position microphone closer

Calendar Sync Issues

Error: "Meeting Not Detected"

Symptoms: Granola doesn't auto-start for scheduled meeting Solutions:

  1. Check calendar connection:

    • Settings > Integrations > Calendar
    • Disconnect and reconnect
  2. Verify event visibility:

    • Event must be on synced calendar
    • You must be an attendee
    • Event needs video link
  3. Force sync:

    • Click sync button in Granola
    • Wait 30 seconds
    • Check if meeting appears

Error: "Calendar Authentication Failed"

Symptoms: Can't connect Google/Outlook calendar Solutions:

1. Clear browser cache
2. Log out of Google/Microsoft account
3. Log back in
4. Try connecting Granola again
5. Use private/incognito browser window

Processing Issues

Error: "Notes Not Appearing"

Symptoms: Meeting ended but no notes generated Solutions:

TimeframeAction
< 2 minWait - processing takes time
2-5 minCheck internet connection
5-10 minRestart Granola app
> 10 minContact support

Error: "Processing Failed"

Symptoms: Error message after meeting Causes:

  • Audio file corrupted
  • Meeting too short (< 2 min)
  • Server issues
  • Storage full

Solutions:

  1. Check Granola status page
  2. Verify sufficient disk space
  3. Try re-uploading if option available
  4. Contact support with meeting ID

Integration Issues

Error: "Zapier Connection Lost"

Symptoms: Automations not triggering Solutions:

  1. Open Zapier dashboard
  2. Find Granola connection
  3. Click "Reconnect"
  4. Re-authorize access
  5. Test Zap manually

Error: "Slack/Notion Sync Failed"

Symptoms: Notes not appearing in connected apps Solutions:

  1. Check integration status in Settings
  2. Verify target workspace permissions
  3. Re-authenticate if expired
  4. Check target channel/database exists

App Issues

Error: "App Won't Start"

Solutions (macOS):

# Force quit Granola
killall Granola

# Clear preferences (caution: resets settings)
rm -rf ~/Library/Preferences/com.granola.*
rm -rf ~/Library/Application\ Support/Granola

# Reinstall
brew reinstall granola

Solutions (Windows):

1. Task Manager > End Granola process
2. Settings > Apps > Granola > Repair
3. If fails, uninstall and reinstall

Error: "Update Failed"

Solutions:

  1. Close Granola completely
  2. Download latest from granola.ai/download
  3. Install over existing version
  4. Restart computer if needed

Error Code Reference

CodeMeaningAction
E001Authentication failedRe-login to Granola
E002Audio capture errorCheck microphone
E003Network errorCheck internet
E004Processing timeoutRetry or contact support
E005Storage fullFree up disk space
E006Calendar sync errorReconnect calendar

When to Contact Support

  • Errors persist after troubleshooting
  • Data loss or corruption
  • Billing issues
  • Feature requests

Support: help@granola.ai

Resources

Next Steps

Proceed to

granola-debug-bundle
for creating diagnostic reports.