notion-api

name	notion-api
version	1.0.0
description	Notion API for workspace automation including databases, pages, blocks, query/filter syntax, and integration patterns
author	workspace-hub
category	business
type	skill
capabilities	["database_operations","page_management","block_manipulation","query_filtering","property_types","relation_rollups","search_api","integration_patterns"]
tools	["notion-api","notion-client","curl","jq"]
tags	["notion","api","databases","pages","blocks","automation","productivity","workspace","integration"]
platforms	["rest-api","python","javascript","web"]
related_skills	["api-integration","todoist-api","obsidian"]
requires	[]
scripts_exempt	true

Notion Api

When to Use This Skill

USE Notion API when:

• Automating database entries and updates
• Building custom dashboards from Notion data
• Syncing data between Notion and external systems
• Creating pages programmatically from templates
• Querying databases with complex filters
• Building integrations with other productivity tools
• Generating reports from Notion databases
• Implementing workflow automations

DON'T USE Notion API when:

• Need real-time sync (API has rate limits)
• Building chat/messaging features (use Slack API)
• Need file storage solution (use dedicated storage)
• Simple task management only (use Todoist API)
• Need offline-first solution (use Obsidian)
• Require sub-second response times

Prerequisites

Create Integration

1. Go to https://www.notion.so/my-integrations
2. Click "New integration"
3. Name: "My Integration"
4. Select workspace
5. Set capabilities (Read/Write content, etc.)
6. Copy the "Internal Integration Token"

Connect Integration to Pages

1. Open the Notion page/database you want to access
2. Click "..." menu (top right)
3. Click "Connections" > "Connect to" > Your integration
4. Integration can now access this page and children

Environment Setup

# Set environment variable
export NOTION_API_KEY="secret_xxxxxxxxxxxxxxxxxxxxx"

# Verify connection
curl -s "https://api.notion.com/v1/users/me" \
    -H "Authorization: Bearer $NOTION_API_KEY" \
    -H "Notion-Version: 2022-06-28" | jq

Python SDK Installation

# Install official Python client
pip install notion-client

# Or with uv
uv pip install notion-client


pip install python-dotenv requests