OSS Tanbou

Notion SDK for JavaScript

View on GitHubProject website

Notion SDK for JavaScript — use the Notion API through an official typed client

OSS scale score 241.7OSS health 89Update pace 9 commits/30d
About these scores

OSS scale score is an unbounded metric that log-compresses and weights Stars, Watchers, Forks, and Contributors. Discovery score is the current OSS scale score minus the score at discovery. Update pace is commits in the last 30 days, growth momentum is the OSS scale score difference within the recent observation window, and OSS health is a 0–100 rating based on available recency, Community Health, and release data.

Stars
5,664
Primary language
TypeScript
License
MIT
Repository last updated
Sep 16, 2026

Overview

`@notionhq/client` is the official JavaScript/TypeScript SDK for the Notion API, providing token/OAuth authentication, endpoint methods, TypeScript types, error classification, retries, and pagination helpers.

Features and best fit

Based on official documentation; not hands-on tested · Content checked:

Call Notion API endpoints through typed client methods

Page, data-source, block, user, and other API operations use parameter objects and return typed TypeScript responses.

Sources: [2][3]

Use built-in retries, error classification, and pagination helpers

The SDK can retry rate-limit/overload and selected server errors, classify client/API errors, and iterate paginated results.

Sources: [2]

For integrating Notion into applications and automation

It is suited to backends, bots, jobs, and integrations that read or write Notion data from JavaScript or TypeScript.

Sources: [2]

Separate the SDK license from Notion API permissions and limits

MIT covers the client library code. Actual data access follows Notion integration permissions and API rules. DEBUG logs may include response bodies and should be handled carefully.

Sources: [2][3]

Official sources

  1. [1]makenotion/notion-sdk-js repository(2026-09-21)
  2. [2]Notion SDK README(2026-09-21)
  3. [3]Notion API documentation(2026-09-21)
  4. [4]Notion SDK MIT license(2026-09-21)
Supplemental curator note

This package is an API client rather than Notion itself or a self-hosted backend. Token/OAuth permissions, the data shared with an integration, API rate limits, and API-version changes remain separate operational concerns. DEBUG logging can include response bodies, so production logging should be configured with sensitive data in mind.

Try it in 3 steps

  1. 1

    Get the source

    git clone --depth 1 https://github.com/makenotion/notion-sdk-js.git
  2. 2

    Enter the repository

    cd notion-sdk-js
  3. 3

    Check the official steps

    Continue with the commands in the README Installation, Quick Start, or Getting Started section.

    find . -maxdepth 1 -iname 'README*' -exec sed -n '1,220p' {} \; -quit
Check the official README

Growth

Growth trends · Last 30 days

5,664 Stars

Trend data is still being collected.

Development activity

Last 90 days · weekly

Commits (last 30 days)
9
Open PRs
24

Development activity is still being collected.

Built with

Categories and tags

Categories

Tags

GitHub data

GitHub dataView detailed GitHub data
View on GitHub

GitHub Topics

  • typescript
  • javascript
  • notion
  • js
  • api-client
  • api
Stars
5,664
Forks
712
Watchers
109
Open issues
57
Contributors
73
Primary language
TypeScript
License
MIT
Repository last updated
Sep 16, 2026
Write a related article

Share a guide or use case for this OSS in Markdown. Articles are published after administrator approval.

Report incorrect information

Tell us if any listing information is incorrect or outdated.