notion-sdk-ldraney (0.2.4)
Published 2026-03-01 18:21:43 +00:00 by forgejo_admin
Installation
pip install --index-url About this package
Python SDK for the Notion API v2025-09-03
notion-sdk
Python SDK for the Notion API. Thin wrapper with 1:1 endpoint mapping, proven with pytest integration tests.
Why
The official Notion MCP integration silently drops properties on database creation/update. This SDK correctly uses initial_data_source.properties and is validated against the live API.
Install
pip install notion-sdk-ldraney
Usage
from notion_sdk import NotionClient
client = NotionClient(api_key="secret_...")
# Create a database with properties that actually work
db = client.create_database(
parent={"type": "page_id", "page_id": "..."},
title=[{"text": {"content": "My DB"}}],
initial_data_source={
"properties": {
"Name": {"type": "title", "title": {}},
"Status": {"type": "select", "select": {
"options": [{"name": "Done", "color": "green"}]
}}
}
}
)
API Coverage
- Search: search
- Pages: create (with template support), get, update (with erase_content), archive, move
- Databases: create (with properties!), get, update, query, archive
- Data Sources: get, update, query, list templates
- Blocks: get, get children, append children, update, delete
- Users: list, get self
- Comments: create, list
Testing
# Set your Notion API key
export NOTION_API_KEY=secret_...
# Run integration tests
pytest tests/ -v
Requirements
Requires Python: >=3.10