# Send Notion to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "notioncli", "name": "Notion", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/JordanCoin/notioncli", "canonicalUrl": "https://clawhub.ai/JordanCoin/notioncli", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/notioncli", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notioncli", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "install.sh", "marketplace.json" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "notioncli", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T12:01:43.522Z", "expiresAt": "2026-05-07T12:01:43.522Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notioncli", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notioncli", "contentDisposition": "attachment; filename=\"notioncli-0.1.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "notioncli" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/notioncli" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/notioncli", "downloadUrl": "https://openagent3.xyz/downloads/notioncli", "agentUrl": "https://openagent3.xyz/skills/notioncli/agent", "manifestUrl": "https://openagent3.xyz/skills/notioncli/agent.json", "briefUrl": "https://openagent3.xyz/skills/notioncli/agent.md" } } ``` ## Documentation ### notioncli — Notion API Skill A powerful CLI for the Notion API. Query databases, manage pages, add comments, and automate your workspace from the terminal. Built for AI agents and humans alike. ### Setup npm install -g notioncli notion init --key $NOTION_API_KEY The init command saves your API key and auto-discovers all databases shared with your integration. Each database gets an alias (a short slug derived from the database title) so you never need to type raw UUIDs. Tip: In Notion, you must share each database with your integration first: open the database → ••• menu → Connections → Add your integration. ### Auto-Aliases When you run notion init, every shared database is automatically assigned a slug alias: Found 3 databases: ✅ projects → Projects ✅ tasks → Tasks ✅ reading-list → Reading List You can then use projects instead of a1b2c3d4-e5f6-... everywhere. Manage aliases manually with: notion alias list # Show all aliases notion alias add mydb # Add a custom alias notion alias rename old new # Rename an alias notion alias remove mydb # Remove an alias ### Database Discovery notion dbs # List all databases shared with your integration notion alias list # Show configured aliases with IDs ### Querying Data notion query tasks # Query all rows notion query tasks --filter Status=Active # Filter by property notion query tasks --sort Date:desc # Sort results notion query tasks --filter Status=Active --limit 10 # Combine options notion query tasks --output csv # CSV output notion query tasks --output yaml # YAML output notion query tasks --output json # JSON output notion --json query tasks # JSON (shorthand) Output formats: table — formatted ASCII table (default) csv — header row + comma-separated values json — full API response as JSON yaml — simple key/value YAML format ### Creating Pages notion add tasks --prop "Name=Buy groceries" --prop "Status=Todo" notion add projects --prop "Name=New Feature" --prop "Priority=High" --prop "Due=2026-03-01" Multiple --prop flags for multiple properties. Property names are case-insensitive and matched against the database schema. ### Updating Pages By page ID: notion update --prop "Status=Done" notion update --prop "Priority=Low" --prop "Notes=Updated by CLI" By alias + filter (zero UUIDs): notion update tasks --filter "Name=Ship feature" --prop "Status=Done" notion update workouts --filter "Name=LEGS #5" --prop "Notes=Great session" ### Reading Pages & Content By page ID: notion get # Page properties notion blocks # Page content (headings, text, lists, etc.) By alias + filter: notion get tasks --filter "Name=Ship feature" notion blocks tasks --filter "Name=Ship feature" ### Deleting (Archiving) Pages notion delete # By page ID notion delete tasks --filter "Name=Old task" # By alias + filter notion delete workouts --filter "Date=2026-02-09" # By alias + filter ### Relations & Rollups notion relations tasks --filter "Name=Ship feature" # See linked pages with titles notion relations projects --filter "Name=Launch CLI" # Explore connections Relations are automatically resolved to page titles in get output. Rollups are parsed into numbers, dates, or arrays instead of raw JSON. ### Blocks CRUD notion blocks tasks --filter "Name=Ship feature" # View page content notion blocks tasks --filter "Name=Ship feature" --ids # View with block IDs notion append tasks "New paragraph" --filter "Name=Ship feature" # Append block notion block-edit "Updated text" # Edit a block notion block-delete # Delete a block Use --ids to get block IDs, then target specific blocks with block-edit or block-delete. ### Appending Content notion append "Meeting notes: discussed Q2 roadmap" notion append tasks "Status update: phase 1 complete" --filter "Name=Ship feature" Appends a paragraph block to the page. ### Users notion users # List all workspace users notion user # Get details for a specific user ### Comments notion comments # By page ID notion comments tasks --filter "Name=Ship feature" # By alias + filter notion comment "Looks good, shipping this!" # By page ID notion comment tasks "AI review complete ✅" --filter "Name=Ship feature" # By alias + filter ### Page Inspector notion props tasks --filter "Name=Ship feature" # Quick property dump notion me # Show bot identity and owner ### Database Management notion db-create "New DB" --prop "Name:title" --prop "Status:select" notion db-update tasks --add-prop "Rating:number" # Add a column notion db-update tasks --remove-prop "Old Column" # Remove a column notion db-update tasks --title "Renamed DB" # Rename database notion templates tasks # List page templates ### Moving Pages notion move tasks --filter "Name=Done task" --to archive # Move by alias notion move tasks --filter "Name=Done task" --to # Move to page ### File Uploads notion upload tasks --filter "Name=Ship feature" ./report.pdf notion upload ./screenshot.png Supports images, PDFs, text files, documents. MIME types auto-detected from extension. ### Search notion search "quarterly report" # Search across all pages and databases ### JSON Output Add --json before any command to get the raw Notion API response: notion --json query tasks notion --json get notion --json users notion --json comments ### 1. Discover available databases notion dbs notion alias list ### 2. Query and filter data notion query tasks --filter Status=Active --sort Date:desc notion --json query tasks --filter Status=Active # Parse JSON programmatically notion query tasks --output csv # CSV for spreadsheet tools ### 3. Create a new entry notion add tasks --prop "Name=Review PR #42" --prop "Status=Todo" --prop "Priority=High" ### 4. Update an existing entry (zero UUIDs) # By alias + filter — no page ID needed notion update tasks --filter "Name=Review PR #42" --prop "Status=Done" # Or by page ID if you already have it notion update --prop "Status=Done" ### 5. Read page content (zero UUIDs) # By alias + filter notion get tasks --filter "Name=Review PR #42" notion blocks tasks --filter "Name=Review PR #42" # Or by page ID notion get notion blocks ### 6. Append notes to a page notion append tasks "Status update: completed phase 1" --filter "Name=Review PR #42" notion append "Status update: completed phase 1" ### 7. Collaborate with comments notion comments tasks --filter "Name=Review PR #42" # Check existing notion comment tasks "AI review complete ✅" --filter "Name=Review PR #42" # Add comment # Or by page ID notion comments notion comment "AI review complete ✅" ### 8. Delete by alias + filter notion delete tasks --filter "Name=Old task" notion delete workouts --filter "Date=2026-02-09" ### 9. Manage database schema notion db-update tasks --add-prop "Priority:select" # Add column notion db-update tasks --remove-prop "Old Field" # Remove column notion db-create "New DB" --prop "Name:title" --prop "Status:select" ### 10. Move pages and upload files notion move tasks --filter "Name=Done" --to archive notion upload tasks --filter "Name=Ship feature" ./report.pdf ### 11. Inspect and debug notion me # Check integration identity notion props tasks --filter "Name=Ship feature" # Quick property dump notion templates tasks # List available templates ### Property Type Reference When using --prop key=value, the CLI auto-detects the property type from the database schema: TypeExample ValueNotestitleName=Hello WorldMain title propertyrich_textNotes=Some textPlain text contentnumberAmount=42.5Numeric valuesselectStatus=ActiveSingle select optionmulti_selectTags=bug,urgentComma-separated optionsdateDue=2026-03-01ISO 8601 date stringcheckboxDone=truetrue, 1, or yesurlLink=https://example.comFull URLemailContact=user@example.comEmail addressphone_numberPhone=+1234567890Phone number stringstatusStatus=In ProgressStatus property ### Multi-Workspace Profiles Manage multiple Notion accounts from one CLI: notion workspace add work --key ntn_work_key # Add workspace notion workspace add personal --key ntn_personal # Add another notion workspace list # Show all notion workspace use work # Switch active notion workspace remove old # Remove one # Per-command override notion query tasks --workspace personal notion -w work add projects --prop "Name=Q2 Plan" # Init with workspace notion init --workspace work --key ntn_work_key Aliases are scoped per workspace. Old single-key configs auto-migrate to a "default" workspace. ### Notion API 2025 — Dual IDs The Notion API (2025-09-03) uses dual IDs for databases: a database_id and a data_source_id. notioncli handles this automatically — when you run notion init or notion alias add, both IDs are discovered and stored. You never need to think about it. ### Troubleshooting "No Notion API key found" — Run notion init --key ntn_... or export NOTION_API_KEY=ntn_... "Unknown database alias" — Run notion alias list to see available aliases, or notion init to rediscover "Not found" errors — Make sure the database/page is shared with your integration in Notion Filter/sort property not found — Property names are case-insensitive; run notion --json query --limit 1 to see available properties ## Trust - Source: tencent - Verification: Indexed source record - Publisher: JordanCoin - Version: 0.1.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-30T12:01:43.522Z - Expires at: 2026-05-07T12:01:43.522Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/notioncli) - [Send to Agent page](https://openagent3.xyz/skills/notioncli/agent) - [JSON manifest](https://openagent3.xyz/skills/notioncli/agent.json) - [Markdown brief](https://openagent3.xyz/skills/notioncli/agent.md) - [Download page](https://openagent3.xyz/downloads/notioncli)