GR

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.zip

Installs 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.
68 charsno explicit “when” trigger
Intermediate

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

You give it
Current Granola version or desired plan change
You get back
Updated application state or subscription tier

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 FromLosingAction Before Downgrade
Business → BasicIntegrations disconnect, history limited to 14 daysExport all notes, save integration configs
Enterprise → BusinessSSO, SCIM, custom retention, analyticsReconfigure authentication, manual user provisioning

Pre-downgrade checklist:

  1. Notify team members of the change
  2. Export critical notes (there is no bulk export — share important notes to Notion or copy individually)
  3. Document active integration configurations
  4. Save any custom templates and recipes
  5. 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

FromToBilling ImpactData ImpactAction Required
BasicBusiness$14/user/mo starts immediatelyFull history restoredConnect integrations
BasicEnterpriseContact sales for pricingFull history restoredSSO/SCIM setup
BusinessEnterprisePrice difference, proratedNo data changeConfigure SSO/SCIM
EnterpriseBusinessPrice reduction, immediateRetain data, lose SSO/SCIMReconfigure auth
BusinessBasicFree, immediateHistory limited to 14 daysExport critical data
AnyAnnual billing10-15% savingsNo data changeConfirm 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

ErrorCauseFix
Update fails to installCorrupted download or cacheClear caches, reinstall: brew reinstall --cask granola
App crashes after updateStale preferencesDelete prefs: defaults delete ai.granola.app
Payment fails on upgradeExpired cardUpdate payment method in Settings > Billing
Features missing after upgradeCache not refreshedLog out and log back in to refresh entitlements
SSO stops working after downgradeEnterprise feature removedSwitch 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

Admin access for organization-level plan changesHomebrew for manual macOS updates

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.

SkillInstallsUpdatedSafetyDifficulty
granola-upgrade-migration (this skill)024dReviewIntermediate
pdf-to-markdown1,1758moReviewBeginner
pptx3936moReviewAdvanced
markitdown1772moReviewIntermediate

Try saying

Example prompts that trigger this skill in your AI assistant.

More by jeremylongshore

View all by jeremylongshore

analyzing-logs

jeremylongshore

Analyze application logs to detect performance issues, identify error patterns, and improve stability by extracting key insights.

14123

ollama-setup

jeremylongshore

Configure auto-configure Ollama when user needs local LLM deployment, free AI alternatives, or wants to eliminate hosted API costs. Trigger phrases: "install ollama", "local AI", "free LLM", "self-hosted AI", "replace OpenAI", "no API costs". Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.

1167

backtesting-trading-strategies

jeremylongshore

Backtest crypto and traditional trading strategies against historical data. Calculates performance metrics (Sharpe, Sortino, max drawdown), generates equity curves, and optimizes strategy parameters. Use when user wants to test a trading strategy, validate signals, or compare approaches. Trigger with phrases like "backtest strategy", "test trading strategy", "historical performance", "simulate trades", "optimize parameters", or "validate signals".

1071

generating-database-seed-data

jeremylongshore

Process this skill enables AI assistant to generate realistic test data and database seed scripts for development and testing environments. it uses faker libraries to create realistic data, maintains relational integrity, and allows configurable data volumes. u... Use when working with databases or data models. Trigger with phrases like 'database', 'query', or 'schema'.

1033

cursor-codebase-indexing

jeremylongshore

Execute set up and optimize Cursor codebase indexing. Triggers on "cursor index setup", "codebase indexing", "index codebase", "cursor semantic search". Use when working with cursor codebase indexing functionality. Trigger with phrases like "cursor codebase indexing", "cursor indexing", "cursor".

885

testing-mobile-apps

jeremylongshore

Execute mobile app testing on iOS and Android devices/simulators. Use when performing specialized testing. Trigger with phrases like "test mobile app", "run iOS tests", or "validate Android functionality".

810

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.

1,1752,667

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

393763

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.

177310

nano-pdf

openclaw

Edit PDFs with natural-language instructions using the nano-pdf CLI.

63300

video-downloader

ComposioHQ

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

101255

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.

68277

Search skills

Search the agent skills registry