← 返回 Skills 市场
jeffreymaomao

Notion Workspace API Tools

作者 Jeffreymaomao · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ suspicious
352
总下载
1
收藏
1
当前安装
3
版本数
在 OpenClaw 中安装
/install notion-tools
功能描述
Use for tasks that read or modify Notion pages, data sources, or blocks via the Notion API.
安全使用建议
This skill appears to do exactly what it says (call the Notion API) and uses only Notion endpoints, but you should verify the runtime will provide a NOTION_KEY before granting access. The SKILL.md also allows reading a fallback token file at ~/.config/notion/api_key — if you use that pattern, understand the skill will read that file to obtain credentials. Because the registry metadata does not declare NOTION_KEY as a required credential, ask the skill author or your operator where the key must come from, and only supply a token you control (prefer a least-privilege integration token). Do not paste your full token into chat; if you install or test this skill and later doubt its behavior, rotate/revoke the Notion key. Finally, confirm the skill's source or owner (source is unknown) before installing so you can trust future automated calls to your workspace.
功能分析
Type: OpenClaw Skill Name: notion-tools Version: 1.0.2 The notion-tools skill bundle provides standard instructions and curl-based examples for interacting with the Notion API. It includes proactive safety guidelines for the AI agent, such as avoiding the disclosure of API keys in outputs and preferring environment variables over local files. The optional fallback to read a credential from `~/.config/notion/api_key` is a common pattern for local CLI tools and is clearly documented in `SKILL.md` and `references/setup.md` without any evidence of malicious intent or data exfiltration.
能力评估
Purpose & Capability
The name, description, and runtime instructions all describe legitimate Notion API operations (search, read, create, update, append, trash/restore). Requested actions and referenced endpoints (https://api.notion.com/v1/...) are consistent with the stated purpose.
Instruction Scope
The SKILL.md stays within Notion API usage and gives concrete curl templates and safety rules. It does instruct the agent to prefer a runtime-provided NOTION_KEY and, as an optional local fallback, to read ~/.config/notion/api_key — which means the agent is explicitly permitted to read a local file for credentials. No unrelated system paths, other services, or external endpoints are referenced.
Install Mechanism
This is instruction-only with no install spec and no code files, so nothing is written to disk by an installer. That is the lowest-risk install model.
Credentials
The skill expects NOTION_KEY and NOTION_VERSION at runtime and provides a local-file fallback (~/.config/notion/api_key), but the registry metadata lists no required environment variables or primary credential. The omission of a declared primary credential (NOTION_KEY) is a mismatch that could confuse users about what secrets are needed and what the skill will access.
Persistence & Privilege
The skill does not request always: true, does not modify other skills or system-wide settings, and is user-invocable only. Autonomous invocation is allowed (platform default) but is not combined here with privileged persistence or broad cross-skill access.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install notion-tools
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /notion-tools 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.2
- Added support and documentation for trashing and restoring pages using the `in_trash` property. - Updated API key management to prefer the runtime-provided `NOTION_KEY` variable, using the local token file only as a fallback. - Improved safety guidance: secrets are now read only when needed for Notion API requests, not during planning or explanation. - Clarified that “trashing” a page is not a permanent delete and updated related instructions. - Expanded workflow and API notes to cover trash, restore, and credential handling workflows.
v1.0.1
**Expanded documentation and added usage references.** - Added new reference files: blocks, examples, property patterns, setup, and troubleshooting. - Clarified recommended API workflows, including search-first and inspect-before-mutate patterns. - Added safety guidelines and environment readiness checks. - Provided links to request/response templates and troubleshooting tips. - Updated API terminology for Notion API version 2025-09-03.
v1.0.0
Initial release of Notion Tools skill. - Provides guides to use the Notion API for managing pages, data sources (databases), and blocks - Supports setup instructions, authentication, and usage examples for all main API endpoints - Documents new "data sources" naming and endpoint changes in API version 2025-09-03 - Lists common property types and formatting for database items - Covers creating, querying, updating pages and data sources, and adding blocks - Notes key usage tips, limitations, and rate limits
元数据
Slug notion-tools
版本 1.0.2
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 3
常见问题

Notion Workspace API Tools 是什么?

Use for tasks that read or modify Notion pages, data sources, or blocks via the Notion API. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 352 次。

如何安装 Notion Workspace API Tools?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install notion-tools」即可一键安装,无需额外配置。

Notion Workspace API Tools 是免费的吗?

是的,Notion Workspace API Tools 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Notion Workspace API Tools 支持哪些平台?

Notion Workspace API Tools 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Notion Workspace API Tools?

由 Jeffreymaomao(@jeffreymaomao)开发并维护,当前版本 v1.0.2。

💬 留言讨论