granola-upgrade-migration
Automates Granola app updates and subscription transitions. Use for version management and plan adjustments.
Install
mkdir -p .claude/skills/granola-upgrade-migration && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/8837" && unzip -o skill.zip -d .claude/skills/granola-upgrade-migration && rm skill.zipInstalls to .claude/skills/granola-upgrade-migration
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Upgrade Granola app versions and migrate between subscription plans.Key capabilities
- →Update Granola desktop app versions
- →Manage subscription plan migrations
- →Add or remove team seats
- →Verify installed application version via CLI
How it works
The skill manages app updates through auto-update preferences or Homebrew and handles plan migrations by verifying feature access and seat management.
Inputs & outputs
When to use granola-upgrade-migration
- →Upgrade Granola desktop app version
- →Switch between free and paid subscription plans
- →Verify installed app version via CLI
- →Troubleshoot update issues
About this skill
Granola Upgrade & Migration
Overview
Manage Granola desktop app updates and subscription plan changes. Granola auto-updates by default, but manual intervention may be needed for major versions or plan migrations that affect feature access.
Prerequisites
- Current Granola version info (Granola menu > About, or check via CLI)
- Admin access for organization-level plan changes
- Data backup awareness before downgrading
Instructions
Step 1 — Check Current Version
# macOS — read version from app bundle
defaults read /Applications/Granola.app/Contents/Info.plist CFBundleShortVersionString 2>/dev/null || echo "Check Granola > About Granola"
Check for available updates: Granola menu bar icon > Check for Updates, or visit granola.ai/updates for the changelog.
Step 2 — Update the Desktop App
Auto-update (recommended): Granola checks for updates automatically and downloads in the background. Enable at:
Granola > Preferences > General > Check for updates automatically: On
Manual update via Homebrew (macOS):
brew update && brew upgrade --cask granola
Manual download: Download latest from granola.ai/download. Close Granola, install over the existing version. Settings and data are preserved.
Step 3 — Handle Update Issues
If Granola crashes or behaves incorrectly after updating:
# Clear caches (preserves your data and authentication)
rm -rf ~/Library/Caches/Granola
# If that doesn't help, reset preferences (you'll need to re-authenticate)
defaults delete ai.granola.app 2>/dev/null
# Nuclear option — full reinstall
brew uninstall --cask granola 2>/dev/null
rm -rf ~/Library/Caches/Granola
rm -rf ~/Library/Preferences/ai.granola.app.plist
brew install --cask granola
Your meeting data is stored server-side and in the local cache (~/Library/Application Support/Granola/cache-v3.json). Reinstalling does not delete your notes.
Step 4 — Upgrade Subscription Plan
Settings (avatar bottom-left) > Account > Subscription > Upgrade
Upgrade paths:
Basic (Free) → Business ($14/user/mo): Immediate, prorated
Business → Enterprise ($35+/user/mo): Contact sales
What changes on upgrade:
Basic → Business:
+ Unlimited meetings (was 25 lifetime)
+ Unlimited history (was 14 days)
+ Slack, Notion, CRM integrations
+ Zapier automation
+ MCP (AI agent integration)
+ Team shared folders
+ Custom templates
+ Public API access
Business → Enterprise:
+ SSO (Okta, Azure AD, Google Workspace)
+ SCIM auto-provisioning
+ Enforced AI training opt-out
+ Usage analytics dashboard
+ Full Enterprise API
+ Custom data retention policies
+ Dedicated account manager
Step 5 — Downgrade with Data Preservation
Before downgrading, understand what you lose:
| Downgrading From | Losing | Action Before Downgrade |
|---|---|---|
| Business → Basic | Integrations disconnect, history limited to 14 days | Export all notes, save integration configs |
| Enterprise → Business | SSO, SCIM, custom retention, analytics | Reconfigure authentication, manual user provisioning |
Pre-downgrade checklist:
- Notify team members of the change
- Export critical notes (there is no bulk export — share important notes to Notion or copy individually)
- Document active integration configurations
- Save any custom templates and recipes
- Verify API consumers are prepared for access loss
Important: Downgrading does not delete your data. Notes remain accessible within the new plan's limits (e.g., Basic only shows last 14 days, but data is preserved if you re-upgrade).
Step 6 — Manage Team Seats
Settings > Team > Manage Seats
Add seats:
- Invite by email or enable SSO auto-provisioning
- New seats are prorated for the billing period
Remove seats:
- Deactivate user in Settings > Team
- User loses access but their shared notes remain
- Seat count reduces on next billing cycle
Reassign seats:
- Deactivate departing user
- Invite replacement user
- No additional charge (same seat count)
Plan Migration Matrix
| From | To | Billing Impact | Data Impact | Action Required |
|---|---|---|---|---|
| Basic | Business | $14/user/mo starts immediately | Full history restored | Connect integrations |
| Basic | Enterprise | Contact sales for pricing | Full history restored | SSO/SCIM setup |
| Business | Enterprise | Price difference, prorated | No data change | Configure SSO/SCIM |
| Enterprise | Business | Price reduction, immediate | Retain data, lose SSO/SCIM | Reconfigure auth |
| Business | Basic | Free, immediate | History limited to 14 days | Export critical data |
| Any | Annual billing | 10-15% savings | No data change | Confirm in Billing |
Output
- Granola updated to latest version
- Subscription plan changed with feature access verified
- Team seats managed (added/removed/reassigned)
- Data preserved through any plan change
Error Handling
| Error | Cause | Fix |
|---|---|---|
| Update fails to install | Corrupted download or cache | Clear caches, reinstall: brew reinstall --cask granola |
| App crashes after update | Stale preferences | Delete prefs: defaults delete ai.granola.app |
| Payment fails on upgrade | Expired card | Update payment method in Settings > Billing |
| Features missing after upgrade | Cache not refreshed | Log out and log back in to refresh entitlements |
| SSO stops working after downgrade | Enterprise feature removed | Switch to Google/Microsoft social login |
Resources
Next Steps
Proceed to granola-ci-integration for automated meeting-to-dev-tool workflows.
When not to use it
- →Performing bulk exports of notes as no bulk export feature exists
Prerequisites
Limitations
- →Downgrading from Business to Basic limits history to 14 days
- →No bulk export functionality for notes
- →Reinstalling does not delete notes but requires re-authentication
How it compares
This workflow automates the verification of versioning and plan-specific feature access compared to manual UI-based updates.
Compared to similar skills
granola-upgrade-migration side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| granola-upgrade-migration (this skill) | 0 | 24d | Review | Intermediate |
| pdf-to-markdown | 1,175 | 8mo | Review | Beginner |
| pptx | 393 | 6mo | Review | Advanced |
| markitdown | 177 | 2mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by jeremylongshore
View all by jeremylongshore →You might also like
pdf-to-markdown
aliceisjustplaying
Convert entire PDF documents to clean, structured Markdown for full context loading. Use this skill when the user wants to extract ALL text from a PDF into context (not grep/search), when discussing or analyzing PDF content in full, when the user mentions "load the whole PDF", "bring the PDF into context", "read the entire PDF", or when partial extraction/grepping would miss important context. This is the preferred method for PDF text extraction over page-by-page or grep approaches.
pptx
anthropics
Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks
markitdown
K-Dense-AI
Convert various file formats (PDF, Office documents, images, audio, web content, structured data) to Markdown optimized for LLM processing. Use when converting documents to markdown, extracting text from PDFs/Office files, transcribing audio, performing OCR on images, extracting YouTube transcripts, or processing batches of files. Supports 20+ formats including DOCX, XLSX, PPTX, PDF, HTML, EPUB, CSV, JSON, images with OCR, and audio with transcription.
nano-pdf
openclaw
Edit PDFs with natural-language instructions using the nano-pdf CLI.
video-downloader
ComposioHQ
Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.
youtube-transcript
michalparkola
Download YouTube video transcripts when user provides a YouTube URL or asks to download/get/fetch a transcript from YouTube. Also use when user wants to transcribe or get captions/subtitles from a YouTube video.