{ "schemaVersion": "1.0", "item": { "slug": "notion-cli-agent", "name": "Notion CLI – Command Line Interface based access to Notion for your agent", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/FroeMic/notion-cli-agent", "canonicalUrl": "https://clawhub.ai/FroeMic/notion-cli-agent", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/notion-cli-agent", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notion-cli-agent", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "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." ], "prompts": [ { "label": "New install", "body": "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." }, { "label": "Upgrade existing", "body": "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." } ] }, "sourceHealth": { "source": "tencent", "slug": "notion-cli-agent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T12:03:25.375Z", "expiresAt": "2026-05-07T12:03:25.375Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notion-cli-agent", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=notion-cli-agent", "contentDisposition": "attachment; filename=\"notion-cli-agent-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "notion-cli-agent" }, "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/notion-cli-agent" }, "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." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/notion-cli-agent", "agentPageUrl": "https://openagent3.xyz/skills/notion-cli-agent/agent", "manifestUrl": "https://openagent3.xyz/skills/notion-cli-agent/agent.json", "briefUrl": "https://openagent3.xyz/skills/notion-cli-agent/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "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." ], "prompts": [ { "label": "New install", "body": "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." }, { "label": "Upgrade existing", "body": "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." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [], "body": "notion-cli Interact with your Notion workspace via the notion-cli.\n\nA production-grade CLI for the Notion API that supports searching, creating and managing pages, databases, blocks, users, and comments with multiple output formats (JSON, table, CSV).\n\nInstall Clone and install the CLI:\n\ngit clone https://github.com/FroeMic/notion-cli\ncd notion-cli\nnpm install\nnpm run build\nnpm link\n\n\nSet NOTION_API_KEY environment variable:\n\nCreate an integration at https://www.notion.so/profile/integrations\nCopy the Internal Integration Secret (starts with ntn_ or secret_)\nShare any pages/databases you want to access with the integration\nRecommended: Add to ~/.claude/.env for Claude Code\nAlternative: Add to ~/.bashrc or ~/.zshrc: export NOTION_API_KEY=\"your-api-key\"\n\nOptional: Set NOTION_DEBUG=true for verbose request/response logging.\n\nRepository: https://github.com/FroeMic/notion-cli\n\nCommands Search across your workspace:\n\nnotion search [query] # Search pages, databases, and data sources\nnotion search [query] --filter page # Search only pages\nnotion search [query] --filter database # Search only databases\nnotion search [query] --sort ascending # Sort by last edited time\n\n\nWork with pages:\n\nnotion pages get # Get page details\nnotion pages create --parent --title # Create a new page\nnotion pages update --properties # Update page properties\nnotion pages archive # Archive a page\nnotion pages restore # Restore an archived page\nnotion pages property # Get a specific property value\n\n\nWork with databases:\n\nnotion databases get # Get database schema\nnotion databases create --parent --title # Create a database\nnotion databases update --title # Update database metadata\nnotion databases query # Query records in a data source\nnotion databases query --filter # Query with filters\nnotion databases query --sort # Query with sorting\n\n\nWork with blocks (page content):\n\nnotion blocks get # Get a block\nnotion blocks children # List child blocks\nnotion blocks append --content # Append new blocks\nnotion blocks update --content # Update a block\nnotion blocks delete # Delete a block\n\n\nWork with users:\n\nnotion users list # List workspace members\nnotion users get # Get user details\nnotion users me # Get the authenticated bot user\n\n\nWork with comments:\n\nnotion comments list --block # List comments on a block\nnotion comments create --page --content # Add a comment to a page\n\n\nGlobal options (available on all commands):\n\n--api-key # Override NOTION_API_KEY env var\n-f, --format # Output format: json (default), table, csv\n--limit # Max results to return\n--cursor # Pagination cursor\n\n\nKey Concepts\n\nConcept\tPurpose\tExample\nPages\tIndividual Notion pages\tA meeting note, a project brief\nDatabases\tStructured collections of pages\tA task tracker, a CRM table\nData Sources\tIndividual tables within a database\tA specific view/table in a database\nBlocks\tContent elements within a page\tParagraphs, headings, lists, code blocks\nProperties\tTyped fields on database pages\tTitle, status, date, select, relation\nUsers\tWorkspace members and integrations\tTeam members, bot integrations\nComments\tDiscussion threads on pages/blocks\tFeedback, review notes\n\nAPI Reference\n\nBase URL: https://api.notion.com/v1\nAPI Version: 2022-06-28\nAuth: Authorization: Bearer $NOTION_API_KEY\nRate Limits: Automatic retry with exponential backoff (up to 3 retries)\n\nCommon API Operations Search for a page:\n\ncurl -X POST https://api.notion.com/v1/search \\\n -H \"Authorization: Bearer $NOTION_API_KEY\" \\\n -H \"Notion-Version: 2022-06-28\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"query\": \"Meeting Notes\", \"filter\": {\"value\": \"page\", \"property\": \"object\"}}'\n\n\nQuery a database with filters:\n\ncurl -X POST https://api.notion.com/v1/databases//query \\\n -H \"Authorization: Bearer $NOTION_API_KEY\" \\\n -H \"Notion-Version: 2022-06-28\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"filter\": {\"property\": \"Status\", \"status\": {\"equals\": \"In Progress\"}}}'\n\n\nCreate a page in a database:\n\ncurl -X POST https://api.notion.com/v1/pages \\\n -H \"Authorization: Bearer $NOTION_API_KEY\" \\\n -H \"Notion-Version: 2022-06-28\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"parent\": {\"database_id\": \"\"}, \"properties\": {\"Name\": {\"title\": [{\"text\": {\"content\": \"New Task\"}}]}}}'\n\n\nAppend content to a page:\n\ncurl -X PATCH https://api.notion.com/v1/blocks//children \\\n -H \"Authorization: Bearer $NOTION_API_KEY\" \\\n -H \"Notion-Version: 2022-06-28\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"children\": [{\"object\": \"block\", \"type\": \"paragraph\", \"paragraph\": {\"rich_text\": [{\"type\": \"text\", \"text\": {\"content\": \"Hello world\"}}]}}]}'\n\n\nNotes\n\nThe integration must be explicitly shared with each page or database you want to access (via Notion UI: ... menu > Connections > Add your integration).\nPages can accept IDs as UUIDs or Notion URLs — the CLI will parse both formats.\nAll list endpoints support cursor-based pagination via --limit and --cursor.\nOutput format can be set to json (default), table, or csv with the -f flag.\nProperty types include: title, rich_text, number, select, multi_select, status, date, people, files, checkbox, url, email, phone_number, relation, rollup, formula, and timestamp fields.\n\nFiles 1 total\n\nSKILL.md (this file)" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/FroeMic/notion-cli-agent", "publisherUrl": "https://clawhub.ai/FroeMic/notion-cli-agent", "owner": "FroeMic", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/notion-cli-agent", "downloadUrl": "https://openagent3.xyz/downloads/notion-cli-agent", "agentUrl": "https://openagent3.xyz/skills/notion-cli-agent/agent", "manifestUrl": "https://openagent3.xyz/skills/notion-cli-agent/agent.json", "briefUrl": "https://openagent3.xyz/skills/notion-cli-agent/agent.md" } }