A skill for reading, searching, creating, editing, and reporting on pages and databases in a Notion workspace, Notion being a collaborative notes and knowledge-management service.

Use it to find and summarize Notion content, query databases, create or update pages, and produce reports from a workspace.

It lets an AI assistant work with live Notion content while checking the workspace structure before making changes and protecting destructive operations.

notion — Skill for Claude Code and Codex by Livus-AI/Skills-MCP

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add Livus-AI/Skills-MCP --skill notion

Clone the repo

git clone --depth 1 https://github.com/Livus-AI/Skills-MCP

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/livus-ai/skills-mcp/notion/github.svg)](https://agentmods.dev/skills/livus-ai/skills-mcp/notion)

Your own site

<a href="https://agentmods.dev/skills/livus-ai/skills-mcp/notion"><img src="https://agentmods.dev/badge/skills/livus-ai/skills-mcp/notion/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/livus-ai/skills-mcp/notion"><img src="https://agentmods.dev/badge/skills/livus-ai/skills-mcp/notion.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 81 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,441 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00081	$0.01441
Opus 5.5	$0.00032	$0.00576
Sonnet 5.5	$0.00016	$0.00288
Haiku 4.5	$0.00008	$0.00144

Measured 2mo ago against content hash f2eb1e62e27b, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

notion scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

The scan reads SKILL.md. This mod also ships 10 executable files (scripts/_notion.py, scripts/append_blocks.py, scripts/create_page.py, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/notion/SKILL.md · 130 lines

How it starts

The opening of the file, as written. The whole thing — 130 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Notion

Operate on a Notion workspace through the Notion REST API (version 2025-09-03, data-source model). Generic and workspace-agnostic: it discovers structure at runtime rather than hardcoding databases.

Three rules govern everything:

Discover before you act — search and inspect the live workspace; never assume structure.
Match what exists — read current state and schemas before writing.
Confirm before you destroy or restructure — reads and additive creates flow freely; archiving, deleting, and structural schema changes require explicit user approval.

Prerequisites

Set NOTION_TOKEN in the project .env (or pass token to any script):

Create an internal integration at https://www.notion.so/profile/integrations
Optionally restrict it to "Read content" only (least privilege).
Share the specific pages/databases with the integration — it sees nothing until you do.
Copy the secret (ntn_…) into NOTION_TOKEN.

Every script returns {"status": "success", ...} or {"status": "error", "message": ...}.

Available scripts

Script	Operation	Safety
`search.py`	Find pages/data sources by title	read — free
`get_database.py`	Resolve a database's data source(s)	read — free
`get_data_source.py`	Inspect a data source's property schema	read — free
`query_data_source.py`	Query rows with filter/sorts + pagination	read — free
`get_page.py`	Read a page's properties and (optional) content	read — free
`create_page.py`	Create a page or data-source row	additive — free
`append_blocks.py`	Append content blocks to a page	additive — free
`update_page.py`	Update properties; archive (trash) a page	archive needs `confirm=true`
`update_data_source.py`	Add/rename/remove properties; rename	structural — needs `confirm=true`

Discover-first workflow

Never operate blind:

Before you...	First call...
Create or query a row	`get_database.py` → `get_data_source.py` (resolve data source + schema)
Create a row / page	`search.py` (avoid duplicates), then match the schema
Edit a page	`get_page.py` (read current state)
Change structure	`get_data_source.py` (know exactly what you're altering)

Read the full file on GitHub · 130 lines

Files

What ships with it

11 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

2mo ago First seen · 130 lines · 81 tokens per session scan A f2eb1e62e27b

Subscribe to this mod's changes

notion is a skill published in the GitHub repository Livus-AI/Skills-MCP (2 stars, last pushed 5mo ago), licensed MIT. It adds 81 tokens to every session and 1,441 once invoked, about $0.0003 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Productivity

notion next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
notionLivus-AI/Skills-MCP	Skill	2	5mo ago	MIT	A	81	Claude Code, Codex
orbit-notionnexu-io/open-design	Skill	106k	today	Apache-2.0	A	117	Claude Code, Codex
agentmailpaperclipai/paperclip	Skill	112k	today	MIT	A	30	Claude Code, Codex
Cortexdanielmiessler/LifeOS	Skill	20k	2d ago	MIT	A	184	Claude Code
rowboat-spacesrowboatlabs/rowboat	Skill	18k	today	Apache-2.0	A	60	Claude Code, Codex
feishuHmbown/CodeWhale	Skill	41k	6d ago	MIT	A	33	Claude Code, Codex
pinchtab-mcppinchtab/pinchtab	Skill	11k	10d ago	MIT	A	52	Claude Code, Codex