openclaw-skill-notion-workspace_skill

This skill helps you manage your Notion workspace from CLI or Python by searching, reading, creating, and appending content.

Python

2.5k

GitHub Stars

2

Bundled Files

2 months ago

Catalog Refreshed

3 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill openclaw/skills --skill openclaw-skill-notion-workspace

_meta.json299 B
SKILL.md2.3 KB

Overview

This skill manages a Notion workspace from the command line or as an importable Python module. It provides search, page reading, database page creation, block appending, and database listing using the Notion REST API with standard Python HTTP libraries.

How this skill works

The skill calls the Notion REST API directly (using urllib/requests) and uses a Notion integration token provided via environment variable or an embedded default. Functions map to API endpoints: search, retrieve page and block children, create a page in a database with properties, append blocks to a page, and list available databases. It respects Notion API versioning and typical rate limits.

When to use it

Automating content creation in a Notion database from scripts or CI jobs.
Quickly searching or backing up page metadata and block content.
Appending logs, notes, or generated text to existing Notion pages.
Listing and discovering databases available to your integration.
Embedding Notion operations inside Python tools without the official SDK.

Best practices

Set NOTION_TOKEN as an environment variable and keep it secret; grant the integration only the pages/databases it needs.
Invite the integration to pages/databases in Notion via Share → Invite before calling API operations.
Respect the approximate rate limit (~3 requests/sec); implement retries or exponential backoff for 429 responses.
Validate page and database IDs (dashes optional) and test operations on a staging workspace first.
Send only necessary properties when creating pages to avoid schema errors from the target database.

Example use cases

Create task pages in a project database from a CI pipeline when a new issue is opened.
Search for meeting notes and export page text for archival or processing.
Append generated summaries or audit logs to a running Notion page.
List databases to build a lightweight Notion index or sitemap for external tools.
Integrate Notion content reads into a chatbot or personal automation script.

FAQ

Set NOTION_TOKEN in your environment; the skill will also fall back to a default token if present in the script.

Do page IDs need dashes?

Either format works: both dashed and dashed-free page IDs are accepted.