jamalex/notion-py

Health v2 · maintenance only

Adoption not part of the score

4372 stars · 470 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

An unofficial Python 3 client for Notion.so's internal API v3, providing an object-oriented interface that maps Notion blocks, collections, and users to Python classes. It supports Markdown conversion, caching, callbacks, and (currently partially disabled) reactive two-way data binding between Python objects and the Notion UI.

Use cases

• programmatically edit Notion pages from Python
• read and write Notion database rows as Python objects
• automate Notion content updates with a script
• sync data between Notion and another API
• trigger actions when Notion content changes
• bulk-update Notion page titles and blocks

When to choose

• you need deeper access to Notion than the official API offers, using the internal v3 API
• you want an ORM-like mapping of Notion records to Python objects
• you're automating personal or internal Notion workspaces with Python 3.5+

When to avoid

• you need a supported, stable API - use Notion's official API client instead
• you rely on real-time Notion-to-Python updates, which are currently broken and disabled
• you're uncomfortable using browser-cookie token_v2 auth against an unofficial endpoint that may break

Facets

library · maturity maintenance

http-client sdk apis developer-tools python cross-platform notion api-client unofficial-api orm-like-mapping two-way-binding

Member repositories

For agents

markdown · JSON · MCP: product_card(name="jamalex/notion-py")