Granola SDK Patterns
jeremylongshore/tons-of-skills-marketplace
Zapier automation patterns and Enterprise API integration for Granola.
Agent-callable Notion tools for searching pages and databases, reading and creating pages, querying data sources, appending content, and managing schemas.
Install Notion
$ npx skills add zapier/connectors --skill notion -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install zapier/connectors notion --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/zapier/connectors.git skills-src && mkdir -p .claude/skills && cp -r skills-src/apps/notion .claude/skills/notion && rm -rf skills-srcUse ~/.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/
Install the "notion" agent skill from https://github.com/zapier/connectors/tree/main/apps/notion into .claude/skills/notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "notion", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/zapier/connectors/tree/main/apps/notionType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add zapier/connectors --skill notion -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install zapier/connectors notion --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zapier/connectors.git skills-src && mkdir -p .agents/skills && cp -r skills-src/apps/notion .agents/skills/notion && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "notion" agent skill from https://github.com/zapier/connectors/tree/main/apps/notion into .agents/skills/notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "notion", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add zapier/connectors --skill notion -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install zapier/connectors notion --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zapier/connectors.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/apps/notion .cursor/skills/notion && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "notion" agent skill from https://github.com/zapier/connectors/tree/main/apps/notion into .cursor/skills/notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "notion", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/zapier/connectors.git --path apps/notion--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add zapier/connectors --skill notion -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install zapier/connectors notion --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zapier/connectors.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/apps/notion .gemini/skills/notion && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "notion" agent skill from https://github.com/zapier/connectors/tree/main/apps/notion into .gemini/skills/notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "notion", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install zapier/connectors notionInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add zapier/connectors --skill notion -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/zapier/connectors.git skills-src && mkdir -p .github/skills && cp -r skills-src/apps/notion .github/skills/notion && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "notion" agent skill from https://github.com/zapier/connectors/tree/main/apps/notion into .github/skills/notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "notion", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add zapier/connectors --skill notion -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install zapier/connectors notion --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/zapier/connectors.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/apps/notion .opencode/skills/notion && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "notion" agent skill from https://github.com/zapier/connectors/tree/main/apps/notion into .opencode/skills/notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "notion", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
notion- GitHub stars
- 176
- Token cost
- ~4.6k tokens
- SKILL.md length
- 1,488 words
- Files
- 80 (incl. scripts, references)
- Skills in repo
- 29
- Repo updated
- First seen
- Licence
- Elastic-2.0
At a glance
Agent-callable Notion tools for searching pages and databases, reading and creating pages, querying data sources, appending content, and managing schemas.
- The user mentions Notion
- SKILL.md covers When to use this, Setup, Scripts and Disambiguation & refusals, plus 3 more sections
- Runs TypeScript and JavaScript scripts from its folder; calls npm, npx and git; reaches api.notion.com
- Edit Notion content
What it does
Notion is an agent skill from zapier/connectors, published by the product's own GitHub organization. Agent-callable Notion tools for searching pages and databases, reading and creating pages, querying data sources, appending content, and managing schemas. Use when the user mentions Notion or wants to find, read, create, or edit Notion content, even if they don't name Notion explicitly.
Its SKILL.md is about 4.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 83 other files, including scripts and reference files (for example `.claude-plugin/plugin.json`, `.codex-plugin/plugin.json` and `.mcp.json`). Compatibility notes: Run npm install --omit=dev in this directory, then node cli.js. The TypeScript source needs Node.js 22.18+; on older Node, run cli.js for build-it-yourself /…
It sits in Productivity & Automation. It works with Notion and Zapier. The repository describes itself as: Connect your agent to the apps you already use - with or without Zapier.
When your agent uses it
- The user mentions Notion
- Edit Notion content
- Even if they dont name Notion explicitly
Example prompts
- “/notion”
Requirements
- Node.js
- Compatibility (from SKILL.md): Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options.
What it can do on your machine
Read from SKILL.md and the folder at commit e48d26f. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 1 file in scripts/ (TypeScript and JavaScript, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
npmnpxgit
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.notion.com
Also links to:
developers.notion.comagentskills.io
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Compatibility
Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options.
From compatibility in the SKILL.md frontmatter.
Context cost
Notion loads about 4.6k tokens when it runs, and up to ~17k if it reads all its reference files. Until then it costs about 74 tokens; SKILL.md has 1,488 words of instructions outside code blocks.
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); the scripts in this folder are not scanned.
SKILL.md
Its licence (Elastic-2.0) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,488 words (~4,574 tokens).
“Tools for working with a Notion workspace against the Notion API (https://api.notion.com/v1/, API version 2025-09-03): find pages and data sources, read and create pages, query data-source rows, append and edit block content, manage database / data-source schemas, read and post…”
- name
- notion
- compatibility
- Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options.
- license
- Elastic-2.0
- metadata.title
- Notion
- metadata.source
- https://github.com/zapier/connectors/blob/main/apps/notion/SKILL.md
- metadata.zapier-app-key
- NotionCLIAPI
- metadata.api-docs
- https://developers.notion.com/reference/intro
Files
SKILL.md and 79 other files (scripts, references) in apps/notion of zapier/connectors.
- SKILL.md
- .claude-plugin/plugin.json
- .codex-plugin/plugin.json
- .mcp.json
- CHANGELOG.md
- LICENSE
- NOTICE
- README.md
- cli.js
- cli.ts
- connections.ts
- evals/evals.json
- evals/results.md
- index.ts
- lib/notionFetch.ts
- lib/notionId.ts
- lib/notionSchemas.ts
- … and 63 more
Open the folder on GitHubat commit e48d26f
Compare with similar skills
Notion 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Notion this skillzapier/connectors | 176 | — | ~4.6k | Automated safety check: Pass | Elastic-2.0 | |
| Granola SDK Patternsjeremylongshore/tons-of-skills-marketplace | 2.8k | — | ~1.8k | Automated safety check: Pass | MIT | |
| Granola Deploy Integrationjeremylongshore/tons-of-skills-marketplace | 2.8k | — | ~1.8k | Automated safety check: Pass | MIT | |
| Connect Apps with ComposioComposioHQ/awesome-claude-skills | 77k | 3 repos | ~557 | Automated safety check: Pass | None | |
| Zapier SDKzapier/sdk | 262 | — | ~2.9k | Automated safety check: Pass | MIT | |
| Zapier Demozapier/zapier-mcp | 428 | — | ~2.7k | Automated safety check: Pass | MIT |
Similar skills
Granola Deploy Integration
jeremylongshore/tons-of-skills-marketplace
Deploy Granola native integrations — Slack, Notion, HubSpot, Attio, Affinity, and Zapier.
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.
- Official
Zapier SDK
zapier/sdk
Zapier SDK for TypeScript. An agent skill from zapier/sdk.
- Official
Zapier Demo
zapier/zapier-mcp
Walk a new user through setting up their first Zapier action and running it live — the smallest possible win.
- Official
Zapier Status
zapier/zapier-mcp
Check the health of your Zapier MCP setup. An agent skill from zapier/zapier-mcp.
More from zapier/connectors
All 29 skills in this repo- Official
Google Ads
zapier/connectors
Agent-callable Google Ads tools — search campaigns, ad groups, and ads via GAQL, build performance reports, manage campaign status and budgets, and set up conversion tracking.
- Official
Linear
zapier/connectors
Agent-callable Linear tools — create, update, find, and comment on issues; manage projects; and resolve teams, states, labels, users, and cycles.
- Official
Alpaca
zapier/connectors
Agent-callable Alpaca trading tools — place and manage stock, crypto, and options orders, read account balances, positions, and portfolio history, look up assets and market hours, and read watchlists.
- Official
Clay
zapier/connectors
Agent-callable Clay tools — create, update, and find rows in Clay tables, and navigate workspaces, tables, views, and users.
- Official
Discord
zapier/connectors
Agent-callable Discord tools — send and manage messages, start threads and forum posts, manage channels, members, and roles, and post via webhooks.
- Official
Dropbox
zapier/connectors
Agent-callable Dropbox tools — upload, organize, find, and share files and folders.
Related
Categories
Questions about Notion
What does Notion do?
Agent-callable Notion tools for searching pages and databases, reading and creating pages, querying data sources, appending content, and managing schemas. Notion is an agent skill from zapier/connectors, published by the product's own GitHub organization. Agent-callable Notion tools for searching pages and databases, reading and creating pages, querying data sources, appending content, and managing schemas.
When should I use Notion?
Notion fits situations like: the user mentions Notion; edit Notion content; even if they dont name Notion explicitly.
How do I install Notion in Claude Code?
Run `npx skills add zapier/connectors --skill notion -a claude-code`. Or copy the skill folder (apps/notion in zapier/connectors) into .claude/skills/notion in your project. Claude Code loads it when a task matches its description.
How do I install Notion in Codex?
Run `npx skills add zapier/connectors --skill notion -a codex`. Or copy the skill folder (apps/notion in zapier/connectors) into .agents/skills/notion in your project. Codex loads it when a task matches its description.
Can I use Notion 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 zapier/connectors --skill notion -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/notion, .gemini/skills/notion, .github/skills/notion and .opencode/skills/notion in your project.
What does Notion need to run?
Going by SKILL.md and its folder, Notion needs TypeScript and JavaScript for the scripts in its folder and the command-line tools its instructions call (npm, npx and git). Our summary lists: Node.js. Compatibility (from SKILL.md): Run `npm install --omit=dev` in this directory, then `node cli.js`. The TypeScript source needs Node.js 22.18+; on older Node, run `cli.js` for build-it-yourself / prebuilt / alternative-runtime options..
Does Notion access the network?
SKILL.md names 3 domains. In commands or code: api.notion.com; the agent is likely to contact it when it follows the instructions. As links in the text: developers.notion.com and agentskills.io. This is read from the text; nothing was executed.
Is Notion 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Notion use?
Notion is published under the Elastic-2.0 licence (declared in SKILL.md).
How many tokens does Notion use?
About 4.6k tokens (SKILL.md is roughly 18k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 13k tokens, read only when the agent opens those files.
What are the alternatives to Notion?
Skills that share tags, products or a category with Notion: Granola SDK Patterns (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Granola Deploy Integration (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Connect Apps with Composio (ComposioHQ/awesome-claude-skills, 77k stars) and Zapier SDK (zapier/sdk, 262 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Notion?
zapier (a GitHub organization, an official publisher) maintains it in zapier/connectors, which has 176 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on August 25, 2026.
Source: zapier/connectors on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.