# Notion Sync

> Read, create, and update Notion pages and databases. Requires Notion API integration token.

- Skill: `fuyuxiang/notion-sync` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add fuyuxiang/notion-sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fuyuxiang/notion-sync/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: fuyuxiang (https://skillmd.com/u/fuyuxiang)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/fuyuxiang/notion-sync

---


# Notion Sync

Notion API integration for pages, databases, and content management.

## Setup

1. Create integration at https://www.notion.so/my-integrations
2. Get Internal Integration Token
3. Share target pages/databases with the integration
4. Set environment: `export NOTION_API_TOKEN=secret_xxx`

## Script

```bash
python3 scripts/notion_client.py --token secret_xxx databases
python3 scripts/notion_client.py --token secret_xxx query <database-id> --limit 20
python3 scripts/notion_client.py --token secret_xxx create <database-id> "Page Title" --content "Body text"
```

## API Usage

```python
import httpx

HEADERS = {
    "Authorization": f"Bearer {NOTION_API_TOKEN}",
    "Notion-Version": "2022-06-28",
    "Content-Type": "application/json",
}

# Search
resp = httpx.post("https://api.notion.com/v1/search",
    headers=HEADERS,
    json={"query": "project plan"})

# Read page blocks
resp = httpx.get(f"https://api.notion.com/v1/blocks/{page_id}/children",
    headers=HEADERS)

# Create page
resp = httpx.post("https://api.notion.com/v1/pages",
    headers=HEADERS,
    json={
        "parent": {"page_id": parent_id},
        "properties": {"title": [{"text": {"content": "New Page"}}]},
        "children": [
            {"paragraph": {"rich_text": [{"text": {"content": "Hello"}}]}}
        ]
    })
```

## Block Types

| Type | Use |
|------|-----|
| paragraph | Normal text |
| heading_1/2/3 | Headers |
| bulleted_list_item | Bullet points |
| numbered_list_item | Numbered lists |
| code | Code blocks |
| toggle | Collapsible sections |
| to_do | Checkboxes |

## Common Workflows

- Save chat notes to Notion page
- Query reading list database
- Create daily journal entry
- Append meeting notes from template