OpenParable
Skip to content
← Back to skills

Notion Sync

Apps & Automation
notion-sync

Notion Sync is an Agent Skill for apps & automation published in the fuyuxiang/echo-agent repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/fuyuxiang/echo-agent/blob/HEAD/skills/productivity/notion-sync/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/notion-sync, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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

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

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

TypeUse
paragraphNormal text
heading_1/2/3Headers
bulleted_list_itemBullet points
numbered_list_itemNumbered lists
codeCode blocks
toggleCollapsible sections
to_doCheckboxes

Common Workflows

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