pd-notion

PREREQUISITE: Read ../pd-shared/SKILL.md for auth and setup.

npx tsx resources/pd-notion.ts <command> [flags]

Command Description Key Flags

search

Search pages/databases --query , --type (page|database), --limit

page

Read page + content --id ✓

create-page

Create a page --parent ✓, --title ✓, --parent-type , --content , --prop

update-page

Update properties --id ✓, --prop ✓

append

Append blocks --id ✓, --text ✓, --type

db-schema

Database columns/types --id ✓

query-db

Query database --id ✓, --filter (JSON), --sort (JSON), --limit

add-row

Add database row --db ✓, --prop ✓

users

List users —

comment

Comment on page --id ✓, --text ✓

Property format: --prop 'Name:type:value'

Types: title , rich_text , select , multi_select , number , checkbox , date , url , email , status .

Examples

npx tsx resources/pd-notion.ts search --query 'Meeting Notes' --type page npx tsx resources/pd-notion.ts page --id abc123 npx tsx resources/pd-notion.ts db-schema --id DB_ID npx tsx resources/pd-notion.ts query-db --id DB_ID --filter '{"property":"Status","select":{"equals":"In Progress"}}' npx tsx resources/pd-notion.ts add-row --db DB_ID --prop 'Name:title:Fix bug' --prop 'Status:select:Todo' npx tsx resources/pd-notion.ts create-page --parent PAGE_ID --title 'New Page' --content 'Hello world'

Tips

• Search first to find IDs. db-schema before query-db /add-row .

• page renders blocks as text: # headings, • bullets, ☑ /☐ todos.

• --parent-type database required when parent is a database.

[!CAUTION] create-page , update-page , append , add-row , comment are write commands.