notion-sdk-py

Notion API client SDK, rewritten in Python! (sync + async)

Python 3.0.0 📦 129/mo 🔐 4.9/10
2.2k stars  ·  168 forks  ·  Updated  ·  MIT
Install
pip install notion-sdk-py
View on GitHub
📄 Documentation
api-clientasyncdataclasseshttpxnotionnotion-apipythonpython-client
Supported APIs (1)

Hello and welcome! To make use of this API collection collection as it's written, please duplicate this database templat

Version history All releases ↗

Thanks to all the contributors for this new major version! ⚠️ Beware of the following breaking changes: * `is_full_page_or_database` has been re…

## What's Changed * Add generate random data example by @Sumeet213 in https://github.com/ramnes/notion-sdk-py/pull/292 * Prevent resource leaks in t…

⚠️ Beware, `Notion-Version` has been upgraded to `2025-09-03`. This version of the SDK is not compatible with older versions of the API. See [Notion's…

## What's Changed * Support file uploads by @tsinglinrain in https://github.com/ramnes/notion-sdk-py/pull/270 ## New Contributors * @tsinglinrain…

## What's Changed * Add `column` body param for block updates * Implement GitHub CI cron job to open issues on new Notion API Changelog by @MassimoG…

## What's Changed * Official support of Python 3.13 * Security update of httpx minimum version * Add `in_trash` property to PagesEndpoint, by @jjon…

Quick fix for iteration helpers that got broken in 2.2.0.

## What's Changed * Icons and covers can now be removed from pages. (Thanks to @FlorianWilhelm for the nudge!) * Support of filter properties on pag…

Quality signals
Score
Stars2.2k
Forks168
Last updated
LicenseMIT
Supported APIs (1)
notion.com
Language
Python
Browse all Python SDKs →
📦 Package statsPyPI ↗
Monthly downloads129
4.9
OpenSSF Scorecard
out of 10 · 2026-03-02
Full report ↗
👁️ Code Review
4/10
🔄 Maintained
10/10
📋 Security Policy
10/10
🪙 Token Permissions
0/10
🔐 Branch Protection
0/10
🔍 Static Analysis (SAST)
0/10