← Back to Skills Marketplace
hith3sh

Notion

by Hithesh Jay · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ✓ Security Clean
61
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install notion-pages
Description
Browse databases, search pages, create and update content, and manage workspace data — powered by ClawLink.
README (SKILL.md)

Notion via ClawLink

Work with Notion from chat — browse databases, search pages, create and update content, and manage workspace data.

Powered by ClawLink, an integration hub for OpenClaw that handles hosted connection flows and credentials so you don't need to configure Notion API access yourself.

Quick start

  1. Install the verified ClawLink plugin: openclaw plugins install clawhub:clawlink-plugin
  2. Start a fresh OpenClaw chat if the plugin was just installed and ClawLink tools are not visible yet
  3. If ClawLink is not configured, call clawlink_begin_pairing
  4. Tell the user to open the returned pairing URL, sign in to ClawLink if needed, and approve the device
  5. After the user confirms approval, call clawlink_get_pairing_status
  6. Tell the user to connect Notion at claw-link.dev/dashboard?add=notion
  7. When the user confirms Notion is connected, call clawlink_list_integrations and then clawlink_list_tools with the notion integration slug

Setup details

Installing the plugin

If the ClawLink plugin is not installed yet, tell the user to run:

openclaw plugins install clawhub:clawlink-plugin

If the current chat started before the plugin was installed and ClawLink tools are still unavailable, tell the user to start a fresh chat so OpenClaw reloads the plugin tool catalog.

Pairing ClawLink

If ClawLink reports that the plugin is not configured, the plugin has not been paired with the user's ClawLink account yet.

  1. Call clawlink_begin_pairing.
  2. Tell the user to open the returned pairing URL in their browser.
  3. The user signs in to ClawLink if needed and approves the OpenClaw device.
  4. After the user confirms approval, call clawlink_get_pairing_status to finish local setup.

The resulting device credential is stored locally in OpenClaw's plugin config and is only sent to claw-link.dev. The user should not paste raw credentials into chat.

Connecting Notion

Tell the user to open https://claw-link.dev/dashboard?add=notion and connect Notion there. The page opens the add-connection panel filtered to Notion. ClawLink's hosted page runs the Notion OAuth flow — the user clicks through the Notion login and authorization screen. When they confirm it is done, call clawlink_list_integrations to verify, then call clawlink_list_tools with integration notion.

Using Notion tools

ClawLink provides tools dynamically based on what the user has connected. You do not need to know tool names or schemas in advance.

Discovery

  1. Call clawlink_list_integrations to confirm Notion is connected.
  2. Call clawlink_list_tools with integration notion.
  3. Treat the returned list as the source of truth. Do not guess or assume what tools exist.
  4. If the user describes a capability but the exact tool is unclear, call clawlink_search_tools with a short query and integration notion.
  5. If no Notion tools appear, direct the user to https://claw-link.dev/dashboard?add=notion.

Execution

  1. Call clawlink_describe_tool before using an unfamiliar tool, before any write, or when the request is ambiguous.
  2. Use the returned schema, whenToUse, askBefore, safeDefaults, examples, and followups.
  3. Prefer read, list, search, and get operations before writes.
  4. For writes or anything marked as requiring confirmation, call clawlink_preview_tool first, then confirm with the user.
  5. Execute with clawlink_call_tool.
  6. If it fails, report the real error. Do not invent results or restate the failure as a missing capability unless the live catalog supports that conclusion.

What you can do

Typical Notion tasks (actual availability depends on the user's connected account, permissions, scopes, and current ClawLink tool catalog):

  • Search pages and databases
  • Browse database entries
  • Read page content
  • Create new pages
  • Update existing pages
  • Query database records with filters
  • Manage comments
  • List workspace users

Rules

  • Always use ClawLink tools for Notion. Do not ask the user for separate Notion credentials.
  • Do not claim a capability is missing without checking the live ClawLink catalog in the current turn.
  • Do not invent slash commands or ask the user to paste raw credentials.
  • Ask for confirmation before destructive, external-facing, or bulk write actions.
  • If Notion is not connected, direct the user to https://claw-link.dev/dashboard?add=notion.
  • Never echo or repeat the user's ClawLink credential.

Resources

Usage Guidance
Before installing, verify the ClawLink plugin/source, review the Notion OAuth permissions, connect only the workspace/pages you intend to expose, and approve write previews only when they match your request.
Capability Analysis
Type: OpenClaw Skill Name: notion-pages Version: 0.1.0 The skill bundle provides a legitimate integration for Notion using the ClawLink service. The instructions in SKILL.md guide the agent through a standard device-pairing and OAuth flow, including explicit safety rules such as requiring user confirmation for destructive actions and prohibiting the echoing of credentials. No evidence of data exfiltration, malicious execution, or obfuscation was found; the architecture relies on a third-party integration hub (claw-link.dev) which is a common pattern for managing API authentication in LLM agents.
Capability Tags
requires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The stated purpose and instructions are coherent for a Notion integration, including browsing, searching, creating, updating, and managing workspace data. The write/manage capabilities are high-impact but disclosed.
Instruction Scope
The skill tells the agent to discover live ClawLink tools, prefer read operations before writes, describe unfamiliar tools, preview writes, and confirm with the user before write or destructive actions.
Install Mechanism
There is no install spec or bundled code, but SKILL.md instructs the user to install the ClawLink plugin. This is user-directed and central to the skill, but it is an external dependency not reviewed here.
Credentials
The skill relies on ClawLink-hosted OAuth and dynamic tools. That is proportionate for the Notion purpose, but it means an external service mediates access to the user's Notion workspace.
Persistence & Privilege
The skill discloses that a ClawLink device credential is stored locally in OpenClaw plugin config and sent to claw-link.dev. This is expected for pairing, but users should understand and revoke access if no longer needed.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install notion-pages
  3. After installation, invoke the skill by name or use /notion-pages
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
- Initial release enabling Notion workspace access via ClawLink integration. - Browse databases, search pages, and manage content within Notion from chat. - No direct API setup required; users connect Notion accounts securely through ClawLink. - Step-by-step pairing and connection instructions included for seamless setup. - Enforces security best practices: does not request or expose user credentials. - Coverage of typical Notion operations (reading, searching, creating, updating, managing users/comments).
Metadata
Slug notion-pages
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Notion?

Browse databases, search pages, create and update content, and manage workspace data — powered by ClawLink. It is an AI Agent Skill for Claude Code / OpenClaw, with 61 downloads so far.

How do I install Notion?

Run "/install notion-pages" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Notion free?

Yes, Notion is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Notion support?

Notion is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Notion?

It is built and maintained by Hithesh Jay (@hith3sh); the current version is v0.1.0.

💬 Comments