Agent skill

Sandbox Notion

Call the Notion API from a Code node or CodeAct action, with NodeTool's request builder and rich-text/block readers running on the host

AGPL-3.0Auto-check passedDocuments & Office

Install Sandbox Notion

skills CLI

$ npx skills add nodetool-ai/nodetool --skill sandbox-notion -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install nodetool-ai/nodetool sandbox-notion --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/sandbox-packs/sandbox-notion .claude/skills/sandbox-notion && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "sandbox-notion" agent skill from https://github.com/nodetool-ai/nodetool/tree/main/packages/sandbox-packs/sandbox-notion into .claude/skills/sandbox-notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sandbox-notion", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/nodetool-ai/nodetool/tree/main/packages/sandbox-packs/sandbox-notion

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add nodetool-ai/nodetool --skill sandbox-notion -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install nodetool-ai/nodetool sandbox-notion --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .agents/skills && cp -r skills-src/packages/sandbox-packs/sandbox-notion .agents/skills/sandbox-notion && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "sandbox-notion" agent skill from https://github.com/nodetool-ai/nodetool/tree/main/packages/sandbox-packs/sandbox-notion into .agents/skills/sandbox-notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sandbox-notion", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add nodetool-ai/nodetool --skill sandbox-notion -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install nodetool-ai/nodetool sandbox-notion --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/packages/sandbox-packs/sandbox-notion .cursor/skills/sandbox-notion && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "sandbox-notion" agent skill from https://github.com/nodetool-ai/nodetool/tree/main/packages/sandbox-packs/sandbox-notion into .cursor/skills/sandbox-notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sandbox-notion", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/nodetool-ai/nodetool.git --path packages/sandbox-packs/sandbox-notion

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add nodetool-ai/nodetool --skill sandbox-notion -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install nodetool-ai/nodetool sandbox-notion --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/packages/sandbox-packs/sandbox-notion .gemini/skills/sandbox-notion && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "sandbox-notion" agent skill from https://github.com/nodetool-ai/nodetool/tree/main/packages/sandbox-packs/sandbox-notion into .gemini/skills/sandbox-notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sandbox-notion", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install nodetool-ai/nodetool sandbox-notion

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add nodetool-ai/nodetool --skill sandbox-notion -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .github/skills && cp -r skills-src/packages/sandbox-packs/sandbox-notion .github/skills/sandbox-notion && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "sandbox-notion" agent skill from https://github.com/nodetool-ai/nodetool/tree/main/packages/sandbox-packs/sandbox-notion into .github/skills/sandbox-notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sandbox-notion", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add nodetool-ai/nodetool --skill sandbox-notion -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install nodetool-ai/nodetool sandbox-notion --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/nodetool-ai/nodetool.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/packages/sandbox-packs/sandbox-notion .opencode/skills/sandbox-notion && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "sandbox-notion" agent skill from https://github.com/nodetool-ai/nodetool/tree/main/packages/sandbox-packs/sandbox-notion into .opencode/skills/sandbox-notion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sandbox-notion", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: sandbox-notion
GitHub stars: 560
Token cost: ~850 tokens
SKILL.md length: 288 words
Files: 2
Skills in repo: 127
Repo updated: Oct 10, 2026
First seen: Oct 7, 2026
Licence: AGPL-3.0

At a glance

Call the Notion API from a Code node or CodeAct action, with NodeTool's request builder and rich-text/block readers running on the host

Documents & Office work in your project
SKILL.md covers request — an authenticated…, plainText — a rich-text array…, toMarkdown — a page's blocks… and Common flows, plus 1 more section
Needs NOTION_API_KEY

What it does

Sandbox Notion is an agent skill from nodetool-ai/nodetool. Call the Notion API from a Code node or CodeAct action, with NodeTool's request builder and rich-text/block readers running on the host

Its SKILL.md is about 850 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `package.json`).

It sits in Documents & Office. It works with Notion. The repository describes itself as: Agent-first Creative Workspace. The licence is AGPL-3.0.

When your agent uses it

Documents & Office work in your project

Example prompts

“/sandbox-notion”

Requirements

A credential in NOTION_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 339f069. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are javascript).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- NOTION_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sandbox Notion loads about 850 tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 288 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~38
When it runs · the whole SKILL.md, loaded when a task matches: ~850

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from nodetool-ai/nodetool at commit 339f069, republished under its AGPL-3.0 licence (© nodetool-ai). 288 words, ~850 tokens.

Download SKILL.mdSave it as .claude/skills/sandbox-notion/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.

name: sandbox-notion
description: Call the Notion API from a Code node or CodeAct action, with NodeTool's request builder and rich-text/block readers running on the host

Notion in the sandbox

Specifier: @nodetool-ai/sandbox-notion. Import it at the top of the body.

Notion is an ordinary HTTPS API and fetch reaches it. What costs a script its first three attempts is everything around the call — the Notion-Version header, the rich-text arrays every piece of text is wrapped in, and the block tree a page's content comes back as. Those three are this pack.

Nothing here sends a request. request builds one; the guest's own fetch sends it, under the run's fetch cap and SSRF guard.

request — an authenticated Notion request

import { request } from "@nodetool-ai/sandbox-notion";

const token = await nodetool.secrets.get("NOTION_API_KEY");
const req = await request({
  token,
  path: "search",
  method: "POST",
  body: { query: inputs.query, page_size: 10 }
});
const res = await fetch(req.url, req);
if (!res.ok) throw new Error(`Notion search failed: ${res.status}`);
return { results: res.json.results };

Options: token (required), path (required — relative to /v1 unless it starts with /), method (default GET), body (JSON-encoded when present), query (query-string bag), version (default 2022-06-28).

Returns {url, method, headers, body?}, which fetch(req.url, req) takes whole.

plainText — a rich-text array as a string

import { plainText } from "@nodetool-ai/sandbox-notion";

const title = await plainText(page.properties.Name.title);

Takes the array Notion puts under every title, rich_text and heading. Anything else gives "".

toMarkdown — a page's blocks as markdown

import { request, toMarkdown } from "@nodetool-ai/sandbox-notion";

const req = await request({ token, path: `blocks/${inputs.page_id}/children`, query: { page_size: 100 } });
const blocks = (await fetch(req.url, req)).json.results;
return { markdown: await toMarkdown(blocks) };

Handles paragraphs, the three heading levels, bulleted and numbered items, to-dos, quotes, code fences and dividers. A block markdown has no form for — a database, an embed, a synced block — contributes nothing rather than a placeholder, so the result is text a model or a file can take as-is.

Common flows

Create a page in a database

const req = await request({
  token, path: "pages", method: "POST",
  body: {
    parent: { database_id: inputs.database_id },
    properties: { Name: { title: [{ text: { content: inputs.title } }] } }
  }
});
const page = (await fetch(req.url, req)).json;

Query a database

const req = await request({
  token, path: `databases/${inputs.database_id}/query`, method: "POST",
  body: { filter: { property: "Status", select: { equals: "Open" } }, page_size: 50 }
});

Gotchas

Every export is async. A host call is a round trip.
Nested blocks are not fetched. toMarkdown is pure over the blocks you hand it. A block with has_children needs its own blocks/{id}/children call.
Notion paginates at 100. Follow next_cursor with query: { start_cursor } and watch the run's fetch cap.
The integration needs access. A page shared with nobody returns 404 even with a valid token — share it with the integration in Notion first.

Files

SKILL.md and 1 other file in packages/sandbox-packs/sandbox-notion of nodetool-ai/nodetool.

SKILL.md
package.json

Open the folder on GitHubat commit 339f069

Compare with similar skills

Sandbox Notion next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sandbox Notion compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Sandbox Notion this skillnodetool-ai/nodetool	560	—	~850	Automated safety check: Pass	AGPL-3.0	yesterday
Baalda Guidenaveedharri/baalda	156	—	~1.8k	Automated safety check: Pass	Apache-2.0	today
Meeting Transcript To Action Itemsskrun-dev/skrun	210	—	~1.3k	Automated safety check: Pass	MIT	18 days ago
Spreadsheet Agentmastra-ai/mastra	29k	—	~2.1k	Automated safety check: Pass	Custom licence	today
Reddit Agencyshawnla90/gtm-coding-agent	155	—	~3.1k	Automated safety check: Pass	MIT	1 mo ago
Notion Manual Importsickn33/agentic-awesome-skills	47k	1 repos	~3.8k	Automated safety check: Pass	MIT	yesterday

Similar skills

Baalda Guide
naveedharri/baalda
Answer any question about Baalda (the team second-brain app at baalda.com) in plain, non-technical language — what it is, what it can and cannot do, which file formats it supports (Markdown, images…
156 GitHub stars~1.8k tokensUpdated today
Documents & OfficeAuto-check passed
Meeting Transcript To Action Items
skrun-dev/skrun
Listen to a meeting recording and extract structured action items, decisions, and open questions.
210 GitHub stars~1.3k tokensUpdated 18 days ago
Documents & OfficeAuto-check passed
Spreadsheet Agent
mastra-ai/mastra
Authoring playbook for building agents that read or write tabular data — Google Sheets, Microsoft Excel, CSV, Airtable, Notion databases, or any spreadsheet.
29k GitHub stars~2.1k tokensUpdated today
Documents & OfficeAuto-check passed
Reddit Agency
shawnla90/gtm-coding-agent
The agency motion for a Reddit-led visibility offer. An agent skill from shawnla90/gtm-coding-agent.
155 GitHub stars~3.1k tokensUpdated 1 mo ago
Documents & OfficeAuto-check passed
Notion Manual Import
sickn33/agentic-awesome-skills
Notion Manual Import: the Notion step for any module - CSV, property mapping, import steps and verification for the field list the active module confirmed.
47k GitHub starsUsed in 1 repo~3.8k tokens
Documents & OfficeAuto-check passed
Alumni Re Hire Tracker
sickn33/agentic-awesome-skills
Alumni and re-hire register: former role, last working day, re-hire eligibility, current employer and re-engagement date, as CSV, SQL, JSON Schema or Notion on request.
47k GitHub starsUsed in 1 repo~3.4k tokens
Documents & OfficeAuto-check passed

More from nodetool-ai/nodetool

All 127 skills in this repo

Beat Sync Editing
nodetool-ai/nodetool
Cut a NodeTool timeline to music and shape its pacing — detect the beat grid, place cuts on phrases, pick a cut type, build speed ramps with time remap, and give the piece an arc.
560 GitHub stars~2.6k tokensUpdated today
Auto-check passed
Caption Titles
nodetool-ai/nodetool
Add and animate a consistent text layer on an existing NodeTool timeline.
560 GitHub stars~1.9k tokensUpdated today
Auto-check passed
Color Motion
nodetool-ai/nodetool
Choose and animate colour on a NodeTool timeline, including shape and text gradients, colour grades, 3D LUTs, and dither.
560 GitHub stars~2.3k tokensUpdated today
Auto-check passed
Commercial Beat Sheet
nodetool-ai/nodetool
Write a shootable, precisely timed commercial beat sheet and store it as a NodeTool storyboard, with a consistent entity roster behind every shot.
560 GitHub stars~4.6k tokensUpdated today
Auto-check passed
Elevenlabs Audio Prompting
nodetool-ai/nodetool
Direct ElevenLabs speech, dialogue, sound effects and music — the bracketed audio tags v3 acts on and why the voice decides whether a tag lands, stability as the delivery dial, punctuation instead…
560 GitHub stars~1.9k tokensUpdated today
Auto-check passed
Frame Composition
nodetool-ai/nodetool
Stage the frame on a NodeTool timeline — grids, focal placement, safe areas per aspect ratio, depth layers and parallax, camera moves, and where elements enter and leave.
560 GitHub stars~3.5k tokensUpdated today
Auto-check passed

Works with

Notion

Questions about Sandbox Notion

What does Sandbox Notion do?

Call the Notion API from a Code node or CodeAct action, with NodeTool's request builder and rich-text/block readers running on the host. Sandbox Notion is an agent skill from nodetool-ai/nodetool.

When should I use Sandbox Notion?

Sandbox Notion fits situations like: documents & Office work in your project.

How do I install Sandbox Notion in Claude Code?

Run `npx skills add nodetool-ai/nodetool --skill sandbox-notion -a claude-code`. Or copy the skill folder (packages/sandbox-packs/sandbox-notion in nodetool-ai/nodetool) into .claude/skills/sandbox-notion in your project. Claude Code loads it when a task matches its description.

How do I install Sandbox Notion in Codex?

Run `npx skills add nodetool-ai/nodetool --skill sandbox-notion -a codex`. Or copy the skill folder (packages/sandbox-packs/sandbox-notion in nodetool-ai/nodetool) into .agents/skills/sandbox-notion in your project. Codex loads it when a task matches its description.

Can I use Sandbox Notion in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add nodetool-ai/nodetool --skill sandbox-notion -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sandbox-notion, .gemini/skills/sandbox-notion, .github/skills/sandbox-notion and .opencode/skills/sandbox-notion in your project.

What does Sandbox Notion need to run?

Going by SKILL.md and its folder, Sandbox Notion needs credentials named NOTION_API_KEY. Our summary lists: A credential in NOTION_API_KEY.

Does Sandbox Notion access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Sandbox Notion safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sandbox Notion use?

Sandbox Notion is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sandbox Notion use?

About 850 tokens (SKILL.md is roughly 3.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Sandbox Notion?

Skills that share tags, products or a category with Sandbox Notion: Baalda Guide (naveedharri/baalda, 156 stars), Meeting Transcript To Action Items (skrun-dev/skrun, 210 stars), Spreadsheet Agent (mastra-ai/mastra, 29k stars) and Reddit Agency (shawnla90/gtm-coding-agent, 155 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sandbox Notion?

nodetool-ai (a GitHub organization) maintains it in nodetool-ai/nodetool, which has 560 GitHub stars. The repository holds 127 skills in this directory. The repository was last updated on October 10, 2026.

Source: nodetool-ai/nodetool on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Sandbox Notion

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Notion in the sandbox

request — an authenticated Notion request

plainText — a rich-text array as a string

toMarkdown — a page's blocks as markdown

Common flows

Gotchas

Files

Compare with similar skills

Similar skills

More from nodetool-ai/nodetool

Related

Questions about Sandbox Notion