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.mdsource 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:
| Cause | Solution |
|---|---|
| Wrong audio input | System Preferences > Sound > Input > Select correct device |
| Microphone muted | Check physical mute button on device |
| Permission denied | Grant microphone access in System Preferences |
| Virtual audio conflict | Disable conflicting audio software |
# Reset audio on macOS sudo killall coreaudiod
Error: "Poor Transcription Quality"
Symptoms: Many errors in transcript Solutions:
- Use quality microphone or headset
- Reduce background noise
- Speak clearly and at moderate pace
- Position microphone closer
Calendar Sync Issues
Error: "Meeting Not Detected"
Symptoms: Granola doesn't auto-start for scheduled meeting Solutions:
-
Check calendar connection:
- Settings > Integrations > Calendar
- Disconnect and reconnect
-
Verify event visibility:
- Event must be on synced calendar
- You must be an attendee
- Event needs video link
-
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:
| Timeframe | Action |
|---|---|
| < 2 min | Wait - processing takes time |
| 2-5 min | Check internet connection |
| 5-10 min | Restart Granola app |
| > 10 min | Contact support |
Error: "Processing Failed"
Symptoms: Error message after meeting Causes:
- Audio file corrupted
- Meeting too short (< 2 min)
- Server issues
- Storage full
Solutions:
- Check Granola status page
- Verify sufficient disk space
- Try re-uploading if option available
- Contact support with meeting ID
Integration Issues
Error: "Zapier Connection Lost"
Symptoms: Automations not triggering Solutions:
- Open Zapier dashboard
- Find Granola connection
- Click "Reconnect"
- Re-authorize access
- Test Zap manually
Error: "Slack/Notion Sync Failed"
Symptoms: Notes not appearing in connected apps Solutions:
- Check integration status in Settings
- Verify target workspace permissions
- Re-authenticate if expired
- 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:
- Close Granola completely
- Download latest from granola.ai/download
- Install over existing version
- Restart computer if needed
Error Code Reference
| Code | Meaning | Action |
|---|---|---|
| E001 | Authentication failed | Re-login to Granola |
| E002 | Audio capture error | Check microphone |
| E003 | Network error | Check internet |
| E004 | Processing timeout | Retry or contact support |
| E005 | Storage full | Free up disk space |
| E006 | Calendar sync error | Reconnect 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.