OSS探訪

Notion SDK for JavaScript

GitHubで見るプロジェクトサイト

Notion SDK for JavaScript — Notion APIをTypeScriptから安全に呼び出す

OSS規模スコア 241.7OSS健全度 89更新ペース 9 Commit/30日
スコアの見方

OSS規模スコアはStars・Watchers・Forks・Contributorsを対数圧縮して重み付けした現在の規模指標（上限なし）です。発掘スコアは現在のOSS規模スコアから発掘時点のOSS規模スコアを引いた値、更新ペースは直近30日Commit数、成長モメンタムは直近の観測期間におけるOSS規模スコア差、OSS健全度は取得できた更新状況・Community Health・Releaseの0〜100評価です。

Stars
5,664
主要言語
TypeScript
ライセンス
MIT
リポジトリ最終更新
2026/09/16

概要

`@notionhq/client`は、Notion APIをJavaScript/TypeScriptから利用する公式SDKです。Integration TokenやOAuth Access Tokenを受け取り、API method、TypeScript型、Error判定、Retry、Pagination helperを提供します。

特徴と向いている用途

公式資料に基づく紹介・実機未検証 · 内容確認日：

Notion API EndpointをTyped Client methodから呼び出す

Page、Data Source、Block、User等のAPIをParameter objectから呼び出し、TypeScript型付きResponseを扱えます。

出典：[2][3]

Retry・Error判定・PaginationをSDK側で補助する

429/529/一部5xxへのAutomatic Retry、isNotionClientError、Async iterator型Pagination helper等を利用できます。

出典：[2]

Notionを業務SystemやAutomationへ統合したい場合に

Notion Dataを読み書きするBackend、Bot、Batch、IntegrationをTypeScript/JavaScriptで実装する用途に向きます。

出典：[2]

SDK LicenseとNotion APIのPermission/Rate Limitを分けて考える

MITなのはSDK codeです。実Data accessはIntegration権限とNotion API仕様に従います。DEBUG logでResponse bodyを出す場合は機密情報にも注意してください。

出典：[2][3]

参考にした公式資料

  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)
編集部からの補足

このPackageはNotion APIへの公式Clientであり、Notion本体やSelf-host Backendではありません。API Token/OAuth Tokenの権限、Integrationへ共有されたData範囲、Notion API側のRate limit/Version変更はSDKとは別に考慮する必要があります。DEBUG loggingではResponse bodyを出力できるため、Production logへ機密Dataを残さない設定も確認してください。

3ステップで試す

  1. 1

    ソースを取得

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

    リポジトリへ移動

    cd notion-sdk-js
  3. 3

    公式手順を確認

    READMEのInstallation / Quick Start / Getting Startedにある公式コマンドを続けて実行してください。

    find . -maxdepth 1 -iname 'README*' -exec sed -n '1,220p' {} \; -quit
公式READMEで確認

成長

成長の推移 · 直近30日

5,664 Stars

推移データを蓄積中です。

開発アクティビティ

直近90日・週次

Commit（直近30日）
9
Open PR
24

開発アクティビティを蓄積中です。

Built with

カテゴリとタグ

カテゴリ

タグ

GitHubデータ

GitHubのデータGitHubの詳細データを見る
GitHubで見る

GitHub Topics

  • typescript
  • javascript
  • notion
  • js
  • api-client
  • api
Stars
5,664
Forks
712
Watchers
109
Open Issues
57
Contributors
73
主要言語
TypeScript
ライセンス
MIT
リポジトリ最終更新
2026/09/16
関連記事を投稿する

このOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。

情報の誤りを報告

掲載内容に誤りや古い情報があればお知らせください。