Notion Sync
Apps & Automationnotion-syncNotion 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.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- 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
- Create integration at https://www.notion.so/my-integrations
- Get Internal Integration Token
- Share target pages/databases with the integration
- 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
| 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