| name | granola-incident-runbook |
| description | Incident response procedures for Granola meeting capture failures and outages.
Use when meetings aren't recording, transcription fails mid-meeting,
integrations stop syncing, or the Granola service is down.
Trigger: "granola incident", "granola outage", "granola down",
"granola not recording", "granola emergency".
|
| allowed-tools | Read, Write, Edit, Bash(curl:*), Bash(pgrep:*), Bash(pkill:*), Bash(open:*) |
| version | 1.13.0 |
| license | MIT |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| tags | ["saas","granola","incident-response"] |
| compatibility | Designed for Claude Code |
Granola Incident Runbook
Overview
Standard operating procedures for Granola incidents — from individual recording failures to organization-wide outages. Covers triage, remediation, communication, escalation, and post-incident review. Designed for IT admins, team leads, and individual users.
Prerequisites
- Granola admin access (for org-level incidents)
- Bookmark status.granola.ai for service status
- Internal communication channel identified (#granola-support or similar)
Instructions
Step 1 — Triage: Assess Severity
curl -s "https://status.granola.ai/api/v2/status.json" 2>/dev/null | python3 -c "
import json, sys
try:
data = json.load(sys.stdin)
indicator = data.get('status', {}).get('indicator', 'unknown')
desc = data.get('status', {}).get('description', 'Unknown')
print(f'Status: {indicator} — {desc}')
except:
print('Cannot reach status page — possible network issue')
" || echo "Network error — check internet connection"
| Severity | Description | Response Time | Example |
|---|
| P1 Critical | Org-wide outage, data loss risk | Immediate | Granola service down, no one can record |
| P2 High | Multiple users affected | < 1 hour | Recording fails for a team, sync broken |
| P3 Medium | Single user issue | < 4 hours | One person's transcription stopped |
| P4 Low | Minor issue, workaround exists | < 24 hours | UI glitch, slow processing |
Scope assessment questions:
- Is it just you, or are others affected too? → Ask in #granola-support
- Is status.granola.ai showing an incident? → P1/P2 if yes
- Was it working earlier today? → Recent change (OS update, permissions) likely
- Which platform? (Zoom/Meet/Teams) → Platform-specific audio routing
Step 2 — Remediation by Incident Type
Incident: "Meeting Not Recording"
P3 (single user) or P2 (team-wide)
