Xpersona
Claim this agent
agentCLAWHUBUnverified

Notion

Notion API for creating and managing pages, databases, and blocks. Skill: Notion Owner: steipete Summary: Notion API for creating and managing pages, databases, and blocks. Tags: latest:1.0.0 Version history: v1.0.0 | 2026-01-04T16:49:20.889Z Archive index: Archive v1.0.0: 3 files, 3027 bytes Files: skill-card.md (1957b), SKILL.md (5039b), _meta.json (125b) File v1.0.0:SKILL.md --- name: notion description: Notion API for creating and managing pages, databases, and blocks. homepage:

OpenClaw
View on ClawHub

Rank

62

Safety

84

Downloads

91k

Updated

Jun 1, 2026

Version

1.0.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 90.7K downloads reported by the source. Last updated 6/1/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Adoption signal
90.7K downloadsadoption · observed Jun 1, 2026
Vendor
Clawhubvendor · observed May 30, 2026
Protocol compatibility
OpenClawcompatibility · observed May 30, 2026
Adoption signal
90.3K downloadsadoption · observed May 30, 2026
Latest release
1.0.0release · observed Jan 4, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s179zksw999xz8ms4cy7pb2fr183m5jq:notion
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-steipete-notion/snapshot"

Documentation

CLAWHUB

7,488 characters of source documentation, loaded on request.

Extracted files

3 files captured from the source.

SKILL.md

---
name: notion
description: Notion API for creating and managing pages, databases, and blocks.
homepage: https://developers.notion.com
metadata: {"clawdbot":{"emoji":"📝"}}
---

# notion

Use the Notion API to create/read/update pages, data sources (databases), and blocks.

## Setup

1. Create an integration at https://notion.so/my-integrations
2. Copy the API key (starts with `ntn_` or `secret_`)
3. Store it:
```bash
mkdir -p ~/.config/notion
echo "ntn_your_key_here" > ~/.config/notion/api_key
```
4. Share target pages/databases with your integration (click "..." → "Connect to" → your integration name)

## API Basics

All requests need:
```bash
NOTION_KEY=$(cat ~/.config/notion/api_key)
curl -X GET "https://api.notion.com/v1/..." \
  -H "Authorization: Bearer $NOTION_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json"
```

> **Note:** The `Notion-Version` header is required. This skill uses `2025-09-03` (latest). In this version, databases are called "data sources" in the API.

## Common Operations

**Search for pages and data sources:**
```bash
curl -X POST "https://api.notion.com/v1/search" \
  -H "Authorization: Bearer $NOTION_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{"query": "page title"}'
```

**Get page:**
```bash
curl "https://api.notion.com/v1/pages/{page_id}" \
  -H "Authorization: Bearer $NOTION_KEY" \
  -H "Notion-Version: 2025-09-03"
```

**Get page content (blocks):**
```bash
curl "https://api.notion.com/v1/blocks/{page_id}/children" \
  -H "Authorization: Bearer $NOTION_KEY" \
  -H "Notion-Version: 2025-09-03"
```

**Create page in a data source:**
```bash
curl -X POST "https://api.notion.com/v1/pages" \
  -H "Authorization: Bearer $NOTION_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{
    "parent": {"database_id": "xxx"},
    "properties": {
      "Name": {"title": [{"text": {"content": "New Item"}}]},
      "Status": {"select": {"name": "Todo"}}
    }
  }'
```

**Query a data source (database):**
```bash
curl -X POST "https://api.notion.com/v1/data_sources/{data_source_id}/query" \
  -H "Authorization: Bearer $NOTION_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{
    "filter": {"property": "Status", "select": {"equals": "Active"}},
    "sorts": [{"property": "Date", "direction": "descending"}]
  }'
```

**Create a data source (database):**
```bash
curl -X POST "https://api.notion.com/v1/data_sources" \
  -H "Authorization: Bearer $NOTION_KEY" \
  -H "Notion-Version: 2025-09-03" \
  -H "Content-Type: application/json" \
  -d '{
    "parent": {"page_id": "xxx"},
    "title": [{"text": {"content": "My Database"}}],
    "properties": {
      "Name": {"title": {}},
      "Status": {"select": {"options": [{"name": "Todo"}, {"name": "Done"}]}},
      "Date": {"date": {}}
    }
  }'
```

**Update page properties:**
```bash
curl -X PATCH "https://api.notion.com/v1/pages/{pa

_meta.json

{
  "ownerId": "kn70pywhg0fyz996kpa8xj89s57yhv26",
  "slug": "notion",
  "version": "1.0.0",
  "publishedAt": 1767545360889
}

skill-card.md

## Description: <br>
Notion API for creating and managing pages, databases, and blocks. <br>

This skill is ready for commercial/non-commercial use. <br>

## Publisher: <br>
[steipete](https://clawhub.ai/user/steipete) <br>

### License/Terms of Use: <br>


## Use Case: <br>
Developers and agents use this skill to configure Notion API access and perform common page, data source, and block operations with curl request examples. <br>

### Deployment Geography for Use: <br>
Global <br>

## Known Risks and Mitigations: <br>
Risk: A Notion API key can grant access to shared workspace content if it is exposed or reused broadly. <br>
Mitigation: Use a dedicated integration, store the API key with restrictive file permissions, and share only the specific pages or databases required. <br>
Risk: POST and PATCH examples can create or modify Notion pages, data sources, and blocks in a real workspace. <br>
Mitigation: Review write requests before running them and test against limited-scope pages or databases first. <br>


## Reference(s): <br>
- [Notion API documentation](https://developers.notion.com) <br>
- [Notion integrations](https://notion.so/my-integrations) <br>
- [ClawHub skill page](https://clawhub.ai/steipete/notion) <br>


## Skill Output: <br>
**Output Type(s):** [Markdown, Shell commands, Configuration, Guidance] <br>
**Output Format:** [Markdown with curl command examples and JSON request bodies] <br>
**Output Parameters:** [1D] <br>
**Other Properties Related to Output:** [Includes Notion API headers, endpoint patterns, credential setup steps, and request payload examples.] <br>

## Skill Version(s): <br>
1.0.0 (source: server release metadata) <br>

## Ethical Considerations: <br>
Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment. <br>

Related agents

Same protocol, similar job.

Github OpenclewUpdated 4mo agoRank 65

@x1pay/langchain

LangChain/LangGraph tools for AI agent x402 payments on X1

OPENCLAW
Github OpenclewUpdated 4mo agoRank 65

oceanbus-langchain

LangChain tools for OceanBus — give your LangChain and CrewAI agents a global identity, encrypted messaging, and Yellow Pages service discovery with a single import.

OPENCLAWoceanbuslangchainlangchain-tools

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "90.7K downloads",
      "href": "https://clawhub.ai/steipete/notion",
      "sourceUrl": "https://clawhub.ai/steipete/notion",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-06-01T00:30:27.087Z",
      "isPublic": true
    },
    {
      "factKey": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "category": "vendor",
      "href": "https://clawhub.ai/steipete/notion",
      "sourceUrl": "https://clawhub.ai/steipete/notion",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-05-30T06:45:54.427Z",
      "isPublic": true,
      "metadata": {}
    },
    {
      "factKey": "protocols",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "category": "compatibility",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-steipete-notion/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-steipete-notion/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-05-30T06:45:54.427Z",
      "isPublic": true,
      "metadata": {}
    },
    {
      "factKey": "traction",
      "label": "Adoption signal",
      "value": "90.3K downloads",
      "category": "adoption",
      "href": "https://clawhub.ai/steipete/notion",
      "sourceUrl": "https://clawhub.ai/steipete/notion",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-05-30T06:45:54.427Z",
      "isPublic": true,
      "metadata": {}
    },
    {
      "factKey": "latest_release",
      "label": "Latest release",
      "value": "1.0.0",
      "category": "release",
      "href": "https://clawhub.ai/steipete/notion",
      "sourceUrl": "https://clawhub.ai/steipete/notion",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-01-04T16:49:20.889Z",
      "isPublic": true,
      "metadata": {}
    },
    {
      "factKey": "handshake_status",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "category": "security",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-steipete-notion/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-steipete-notion/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true,
      "metadata": {}
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.0.0",
      "description": "",
      "href": "https://clawhub.ai/steipete/notion",
      "sourceUrl": "https://clawhub.ai/steipete/notion",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-01-04T16:49:20.889Z",
      "isPublic": true,
      "metadata": {}
    }
  ]
}

Record generated Oct 9, 2026.

Sponsored

Ads related to Notion and adjacent AI workflows.