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 <page_id>

Append blocks:

notion-cli block append <page_id> --markdown "..."

Prefer appending over rewriting content.

Create page:

notion-cli page create --parent <page_id> --title "..."

Databases

Inspect schema:

notion-cli db get <database_id>

Query database:

notion-cli db query <database_id> --filter <json> --sort <json>

Create row:

notion-cli page create --database <database_id> --props <json>

Update row:

notion-cli page update <page_id> --props <json>

Schema Changes (Advanced)

Always inspect diffs before applying schema changes.

Never modify database schema without explicit confirmation.

Recommended flow:

notion-cli db schema diff <database_id> --desired <json>
notion-cli db schema apply <database_id> --desired <json>

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

整体质量中规中矩，文档清晰易懂，能帮助用户快速上手 Notion API 操作。优点是配置说明详细、命令示例丰富、安全提示到位。不足之处在于功能较为基础，缺少进阶用法和故障排除指导，且严重依赖外部付费服务。对于简单的 Notion 读写需求够用，但对复杂场景支持不足。