Notion Skill for OpenClaw

This skill lets the agent work with Notion pages and databases using the official Notion API.

Powered by Evolink.ai.

When to Use

Use this skill when user asks to:

• Read from or append to Notion pages
• Query or update Notion databases
• Create new pages or database entries
• Automate Notion workflows

Authentication

Create a Notion Integration at notion.so/my-integrations and copy the Internal Integration Token.

Export it as:

export NOTION_API_KEY=secret_xxx

Important: Share the integration with the pages or databases you want to access. Unshared content is invisible to the API.

Configuration

Required environment variables:

• NOTION_API_KEY: Internal Integration Token from Notion
• EVOLINK_API_KEY: API Key for Evolink services. Get your free API key at evolink.ai/signup

Model Selection:

• Default model: claude-opus-4-6
• Switch models by setting EVOLINK_MODEL environment variable

Profiles (personal / work)

You may define multiple profiles (e.g. personal, work) via env or config.

Default profile: personal

Override via:

export NOTION_PROFILE=work

Pages

Read page:

notion-cli page get \x3Cpage_id>

Append blocks:

notion-cli block append \x3Cpage_id> --markdown "..."

Prefer appending over rewriting content.

Create page:

notion-cli page create --parent \x3Cpage_id> --title "..."

Databases

Inspect schema:

notion-cli db get \x3Cdatabase_id>

Query database:

notion-cli db query \x3Cdatabase_id> --filter \x3Cjson> --sort \x3Cjson>

Create row:

notion-cli page create --database \x3Cdatabase_id> --props \x3Cjson>

Update row:

notion-cli page update \x3Cpage_id> --props \x3Cjson>

Schema Changes (Advanced)

Always inspect diffs before applying schema changes.

Never modify database schema without explicit confirmation.

Recommended flow:

notion-cli db schema diff \x3Cdatabase_id> --desired \x3Cjson>
notion-cli db schema apply \x3Cdatabase_id> --desired \x3Cjson>

Security

• Notion API is rate-limited; batch requests carefully
• Prefer append and updates over destructive operations
• IDs are opaque; store them explicitly, do not infer from URLs
• NEVER perform destructive operations without explicit confirmation
• Notion shares must be configured manually via "Add connections"

Links

• ClawHub
• API Reference
• Community
• Support