Agent skill

Granola SDK Patterns

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Zapier automation patterns and Enterprise API integration for Granola.

MITAuto-check passedProductivity & Automation

Install Granola SDK Patterns

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill granola-sdk-patterns -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace granola-sdk-patterns --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/saas-packs/granola-pack/skills/granola-sdk-patterns .claude/skills/granola-sdk-patterns && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
granola-sdk-patterns
GitHub stars
2.8k
Token cost
~1.8k tokens
SKILL.md length
442 words
Files
1
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Zapier automation patterns and Enterprise API integration for Granola.

  • Works in 5 steps: Understand Zapier Triggers → Build Common Zap Patterns → Use the Enterprise API → …
  • Building automated workflows
  • SKILL.md covers Overview, Prerequisites, Instructions and Output, plus 4 more sections
  • Calls curl and jq; reaches api.granola.ai and api.workos.com; needs GRANOLA_API_KEY

What it does

Granola SDK Patterns is an agent skill from jeremylongshore/tons-of-skills-marketplace. Zapier automation patterns and Enterprise API integration for Granola. Use when building automated workflows, connecting Granola to 8,000+ apps via Zapier, or querying the Enterprise API for notes and transcripts. Trigger: "granola zapier", "granola automation", "granola API", "granola SDK".

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for Claude Code

It sits in Productivity & Automation, covering Workflow automation and Third-party API integration. It works with Zapier, HubSpot, Notion and Slack. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Building automated workflows
  • Connecting Granola to 8
  • 000+ apps via Zapier
  • Querying the Enterprise API for notes and transcripts

Example prompts

  • “granola zapier”
  • “granola automation”
  • “granola API”
  • “/granola-sdk-patterns”

Requirements

  • A credential in GRANOLA_API_KEY
  • Compatibility (from SKILL.md): Designed for Claude Code
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash(curl:*)

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Understand Zapier Triggers
  2. Build Common Zap Patterns
  3. Use the Enterprise API
  4. Multi-Step Automation Chains
  5. Folder-Based Routing

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash(curl:*)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.granola.ai
    • api.workos.com

    Also links to:

    • zapier.com
    • docs.granola.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GRANOLA_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Claude Code

    From compatibility in the SKILL.md frontmatter.

Context cost

Granola SDK Patterns loads about 1.8k tokens when it runs. Until then it costs about 78 tokens; SKILL.md has 442 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~78
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 442 words, ~1,817 tokens.

Download SKILL.mdSave it as .claude/skills/granola-sdk-patterns/SKILL.md (or your agent's skills folder).
name
granola-sdk-patterns
description
Zapier automation patterns and Enterprise API integration for Granola. Use when building automated workflows, connecting Granola to 8,000+ apps via Zapier, or querying the Enterprise API for notes and transcripts. Trigger: "granola zapier", "granola automation", "granola API", "granola SDK".
allowed-tools
Read, Write, Edit, Bash(curl:*)
compatibility
Designed for Claude Code
version
1.13.0
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, granola, automation, api

Granola SDK Patterns

Overview

Granola does not have a traditional SDK. Integration is achieved through three channels: Zapier (8,000+ app connections), the Enterprise API (REST, workspace-level read access), and native integrations (Slack, Notion, HubSpot, Attio, Affinity). This skill covers automation patterns for all three.

Prerequisites

  • Granola Business plan ($14/user/month) for Zapier + native CRM
  • Enterprise plan ($35+/user/month) for API access
  • Zapier account for automation workflows

Instructions

Step 1 — Understand Zapier Triggers

Granola provides two Zapier triggers:

TriggerFires WhenUse Case
Note Added to Granola FolderA note is placed in a specific folderAuto-route by meeting type
Note Shared to ZapierYou manually share a note to ZapierSelective sharing for important meetings

Webhook payload data available:

  • title — meeting title from calendar
  • creator_name / creator_email — note creator
  • attendees[] — array of {name, email} objects
  • calendar_event_title — original calendar event name
  • calendar_event_datetime — meeting date/time
  • note_content — the enhanced note content (Markdown)
Step 2 — Build Common Zap Patterns

Pattern 1: Meeting Notes to Notion (auto-archive)

yaml
Trigger: Note Added to Granola Folder ("All Meetings")
Action: Notion — Create Database Item
  Database: Meeting Archive
  Title: "{{title}}"
  Date: "{{calendar_event_datetime}}"
  Content: "{{note_content}}"
  Attendees: "{{attendees}}"

Pattern 2: Action Items to Asana/Linear

yaml
Trigger: Note Shared to Zapier
Filter: note_content contains "Action Items"
Code Step (JavaScript):
  const lines = inputData.note_content.split('\n');
  const actions = lines
    .filter(l => l.match(/^- \[ \]/))
    .map(l => l.replace('- [ ] ', ''));
  output = actions.map(a => ({task: a}));
Action: Linear — Create Issue (for each action)
  Title: "{{task}}"
  Team: Engineering
  Label: "meeting-action"

Pattern 3: Sales Call Summary to Slack + HubSpot

yaml
Trigger: Note Added to Granola Folder ("Sales Calls")
Path A — Slack:
  Action: Post Message to #sales-updates
  Message: |
    *New Sales Call:* {{title}}
    *Attendees:* {{attendees}}

    {{note_content}}

    [View full notes in Granola]

Path B — HubSpot (via Zapier if not using native):
  Action: Find Contact by Email ({{attendees[0].email}})
  Action: Create Engagement Note
    Body: "{{note_content}}"

Pattern 4: Meeting Follow-Up Email

yaml
Trigger: Note Shared to Zapier
Action: ChatGPT — Generate Follow-Up Email
  Prompt: "Write a professional follow-up email based on: {{note_content}}"
Action: Gmail — Create Draft
  To: "{{attendees}}"
  Subject: "Follow-up: {{title}}"
  Body: "{{chatgpt_response}}"
Action: Slack — Notify
  Message: "Follow-up draft ready for: {{title}}"
Step 3 — Use the Enterprise API

Available on Enterprise plan. API keys generated at Settings > API Keys (up to 5 per workspace).

bash
# List all accessible notes (paginated)
curl -s "https://api.granola.ai/v0/notes" \
  -H "Authorization: Bearer $GRANOLA_API_KEY" \
  -H "Content-Type: application/json" | jq '.notes[:3]'

# Get a specific note with transcript
curl -s "https://api.granola.ai/v0/notes/{note_id}" \
  -H "Authorization: Bearer $GRANOLA_API_KEY" | jq '{title, summary, action_items}'

API characteristics:

  • Bearer token authentication
  • Read-only access to publicly shared notes within your workspace
  • Rate limited per workspace (429 response when exceeded)
  • Pagination for list endpoints

Reverse-engineered endpoints (unofficial, for reference):

POST https://api.granola.ai/v2/get-documents    # List documents (paginated)
POST https://api.granola.ai/v1/get-document-transcript  # Get transcript
POST https://api.granola.ai/v1/get-workspaces    # List workspaces
POST https://api.granola.ai/v1/get-documents-batch  # Bulk fetch by IDs

Authentication uses WorkOS with refresh token rotation via POST https://api.workos.com/user_management/authenticate.

Step 4 — Multi-Step Automation Chains
yaml
Name: Complete Meeting Follow-Up Pipeline

Step 1 — Trigger:
  Granola: Note Added to Folder ("Client Meetings")

Step 2 — Filter:
  Only continue if attendees contain external email domains

Step 3 — Action:
  ChatGPT: Generate structured summary and follow-up email

Step 4 — Action:
  Gmail: Create draft follow-up email to external attendees

Step 5 — Action:
  Notion: Create page in Client Meeting Log database

Step 6 — Action:
  Linear: Create issues from action items with "client" label

Step 7 — Action:
  Slack: Post summary to #client-updates channel

Step 8 — Action:
  HubSpot: Log meeting note on matched Contact/Deal
Show full SKILL.md (196 more words)Show less
Step 5 — Folder-Based Routing

Organize Granola folders to drive different Zap behaviors:

FolderZapier TriggerActions
Sales CallsAutoSlack #sales + HubSpot + follow-up email
EngineeringAutoLinear tasks + Notion wiki
All HandsAutoSlack #general + Google Drive archive
InterviewsManual shareGreenhouse scorecard + hiring panel Slack
1-on-1sNonePrivate, no automation

Output

  • Zapier workflows configured for automated note processing
  • API access established for custom integrations
  • Multi-step automation chains routing by meeting type
  • Folder-based routing strategy implemented

Error Handling

ErrorCauseFix
Zapier trigger not firingFolder trigger misconfiguredVerify the exact folder name in Zapier matches Granola
Missing note contentNote still processingAdd a 2-minute delay step at the start of the Zap
API 429 Too Many RequestsRate limit exceededAdd delays between requests, implement backoff
API 401 UnauthorizedInvalid or expired API keyRegenerate key at Settings > API Keys
Attendee data emptyCalendar event has no attendee listAdd attendees to the calendar event

Examples

sdk=v3; env=sandbox; fixture=meeting-basic-v2; malformed=blocked; retention=none; telemetry=aggregate-only; rollback=client-r4 documents a typed client test without transmitting a real note.

Resources

Next Steps

Proceed to granola-common-errors for troubleshooting.

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in plugins/saas-packs/granola-pack/skills/granola-sdk-patterns of jeremylongshore/tons-of-skills-marketplace.

Open the folder on GitHubat commit cfae287

Compare with similar skills

Granola SDK Patterns next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Granola SDK Patterns compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Granola SDK Patterns this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.8kAutomated safety check: PassMIT
Connect Apps with ComposioComposioHQ/awesome-claude-skills77k3 repos~557Automated safety check: PassNone
Zapier Statuszapier/zapier-mcp430—~1.8kAutomated safety check: PassMIT
Media Inbox Triagezapier/gtm-cheat-codes342—~1.6kAutomated safety check: PassMIT
MCP Sheet Cache Bridgezapier/gtm-cheat-codes342—~905Automated safety check: PassMIT
Integrationsbutterbase-ai/butterbase-skills534—~832Automated safety check: PassMIT

Similar skills

  • Connect Apps with Composio

    ComposioHQ/awesome-claude-skills

    Connects an agent to 1000+ external apps through the Composio Tool Router plugin, so it can actually send emails, create issues and post messages instead of only drafting them.

    77k GitHub starsUsed in 3 repos~557 tokens
    Productivity & AutomationAuto-check passed
  • Zapier Status

    zapier/zapier-mcp

    Official

    Check the health of your Zapier MCP setup. An agent skill from zapier/zapier-mcp.

    430 GitHub stars~1.8k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Media Inbox Triage

    zapier/gtm-cheat-codes

    Official

    Sorts a shared Gmail inbox for press, partnership and high-intent requests, scores urgency, suggests an owner and routes items through Zapier MCP for human review.

    342 GitHub stars~1.6k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • MCP Sheet Cache Bridge

    zapier/gtm-cheat-codes

    Official

    Designs an event-driven Google Sheets cache tab that mirrors a Zapier Tables source of truth, so spreadsheet-based tools keep working without direct API reads.

    342 GitHub stars~905 tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Integrations

    butterbase-ai/butterbase-skills

    Use BEFORE recommending or installing any third-party SaaS SDK for email (Resend, SendGrid, Postmark, Mailgun), SMS (Twilio), messaging (Slack), calendar (Google Calendar), CRM (HubSpot…

    534 GitHub stars~832 tokensUpdated 5 days ago
    Sales & SupportAuto-check passed
  • Official

    Guides designing and building an official Apify integration for a company's product: workflow-automation apps, AI agent plugins, AI framework packages or direct API clients.

    2.4k GitHub stars~3.4k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Questions about Granola SDK Patterns

What does Granola SDK Patterns do?

Zapier automation patterns and Enterprise API integration for Granola. Granola SDK Patterns is an agent skill from jeremylongshore/tons-of-skills-marketplace. Zapier automation patterns and Enterprise API integration for Granola.

When should I use Granola SDK Patterns?

Granola SDK Patterns fits situations like: building automated workflows; connecting Granola to 8; 000+ apps via Zapier; querying the Enterprise API for notes and transcripts.

How do I install Granola SDK Patterns in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill granola-sdk-patterns -a claude-code`. Or copy the skill folder (plugins/saas-packs/granola-pack/skills/granola-sdk-patterns in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/granola-sdk-patterns in your project. Claude Code loads it when a task matches its description.

How do I install Granola SDK Patterns in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill granola-sdk-patterns -a codex`. Or copy the skill folder (plugins/saas-packs/granola-pack/skills/granola-sdk-patterns in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/granola-sdk-patterns in your project. Codex loads it when a task matches its description.

Can I use Granola SDK Patterns in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill granola-sdk-patterns -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/granola-sdk-patterns, .gemini/skills/granola-sdk-patterns, .github/skills/granola-sdk-patterns and .opencode/skills/granola-sdk-patterns in your project.

What does Granola SDK Patterns need to run?

Going by SKILL.md and its folder, Granola SDK Patterns needs the command-line tools its instructions call (curl and jq) and credentials named GRANOLA_API_KEY. Our summary lists: A credential in GRANOLA_API_KEY. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash(curl:*). Compatibility (from SKILL.md): Designed for Claude Code.

Does Granola SDK Patterns access the network?

SKILL.md names 4 domains. In commands or code: api.granola.ai and api.workos.com; the agent is likely to contact these when it follows the instructions. As links in the text: zapier.com and docs.granola.ai. This is read from the text; nothing was executed.

Is Granola SDK Patterns safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Granola SDK Patterns use?

Granola SDK Patterns is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Granola SDK Patterns use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Granola SDK Patterns?

Skills that share tags, products or a category with Granola SDK Patterns: Connect Apps with Composio (ComposioHQ/awesome-claude-skills, 77k stars), Zapier Status (zapier/zapier-mcp, 430 stars), Media Inbox Triage (zapier/gtm-cheat-codes, 342 stars) and MCP Sheet Cache Bridge (zapier/gtm-cheat-codes, 342 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Granola SDK Patterns?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.