Notion SDK
Official client library for interacting with the Notion API programmatically.
SDKs for hosted services npm MIT
How Notion SDK is used
Notion SDK is a dependency in 19 of the 6,208 public GitHub projects set up for AI coding agents that we scanned, too few to describe it from them alone. Our scan also samples projects by dependency (Solana 2,661, Ethereum and EVM 1,496, 3D and games 2,818, agent frameworks and SDKs 10,983); counting those, it appears in 44 projects, and what it is used with below comes from all of them. The most used alternative in our scan is Google APIs Client Library (73 projects). Projects that use it most often also use Next.js (56.8%), React (68.2%), Axios (31.8%).
Notion SDK popularity over time
Gid Score 47: downloads 65, use in agent projects 39, GitHub stars 41, downloads trend n/a (each 0-100). How it is calculated.
Often used with Notion SDK
| Next.js | 56.8% of Notion SDK projects · 3.2× more than average |
|---|---|
| React | 68.2% of Notion SDK projects · 2.1× more than average |
| Axios | 31.8% of Notion SDK projects · 4.2× more than average |
| TypeScript | 84.1% of Notion SDK projects · 1.5× more than average |
| Zod | 54.5% of Notion SDK projects · 2.2× more than average |
| OpenAI | 29.5% of Notion SDK projects · 6.5× more than average |
| Tailwind Merge | 45.5% of Notion SDK projects · 2.4× more than average |
| pg | 27.3% of Notion SDK projects · 5.8× more than average |
From all 44 projects in our scan that use Notion SDK, including the dependency samples.
By coding agent
| Claude Code | 0.4% of projects set up for it |
|---|---|
| GitHub Copilot | 0.3% of projects set up for it |
| Cursor | 0.3% of projects set up for it |
Share of public repos configured for each agent that list Notion SDK as a dependency.
Agent Skills for Notion SDK
| client-report-narratives from irinabuht12-oss/marketing-skills | Takes your raw campaign performance data and writes the executive summary paragraph that goes at the top of the report. The plain English explanation of what h…npx skills add irinabuht12-oss/marketing-skills --skill client-report-narratives |
|---|---|
| client-reverse from Netw0rkNoob/VulnClaw | 客户端逆向与Burp重放 — 复杂客户端签名恢复、加密还原、请求链追踪、稳定重放，适用于已授权安卓App渗透测试、浏览器JS签名、桌面客户端逆向npx skills add Netw0rkNoob/VulnClaw --skill client-reverse |
| client-onboarding from indranilbanerjee/digital-marketing-pro | Build a client onboarding pack: kickoff agenda, discovery questions, 30-60-90. "we just signed a new client"npx skills add indranilbanerjee/digital-marketing-pro --skill client-onboarding |
Skills teach your coding agent how to use Notion SDK well. Official means the pack comes from the same GitHub account as Notion SDK. Read a skill before installing it: it can include scripts. All Agent Skills
Install
| Package | npm install @notionhq/client |
|---|---|
| Main stacks | Next.js (25), TypeScript / JavaScript (17), Python (2) |
| Example projects | wanikua/danghuangshang, jasonhedman/toolkit.dev, Othmane-Khadri/YALC-the-GTM-operating-system, updatesettings/nextjs-candy-machine-v2, checkly/srebot |
Alternatives to Notion SDK
Tools that do the same job, so a project picks one or the other. Add-ons and libraries used alongside Notion SDK are not listed here; they are in "Often used with".
| Tool | Gid Score | Used in agent projects | Downloads / wk | GitHub stars | License |
|---|---|---|---|---|---|
| Google APIs Client Library npm Official SDK for calling Google APIs from Node.js applications. |
66 | 73 (1.5%) | 6.2M | 12.3K | Apache-2.0 |
| Firebase Admin SDK npm Official SDK for building server-side Firebase applications. |
58 | 47 (1.0%) | 5.9M | 1,748 | Apache-2.0 |
More in SDKs for hosted services: Supabase JS Supabase SSR AWS SDK for JavaScript (S3) Resend Stripe (JavaScript) Supabase CLI Firebase Stripe.js