notion

notion is a skill for Claude Code, Codex from mnlt/teleport. It costs 68 tokens per session (2,068 once invoked), scanned B, original, MIT.

An integration for reading and changing Notion pages, databases, and content blocks through Notion's web API. Notion is a workspace for documents and structured tables.

In plain words
What is it for?
Searching the workspace, querying databases, creating or updating pages, and adding content to existing pages.
Why use it?
It removes the need to copy information manually between an agent and a Notion workspace.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: reads .claude/ paths; mentions Claude Code.

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.

agentmods
npx agentmods add skills/mnlt/teleport/notion
Any agent
npx skills add mnlt/teleport --skill notion
Clone the repo
git clone --depth 1 https://github.com/mnlt/teleport

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.

agentmods badge for notion

README.md
[![agentmods](https://agentmods.dev/badge/skills/mnlt/teleport/notion.svg)](https://agentmods.dev/skills/mnlt/teleport/notion)
Your own site
<a href="https://agentmods.dev/skills/mnlt/teleport/notion"><img src="https://agentmods.dev/badge/skills/mnlt/teleport/notion.svg" alt="Measured on agentmods" height="20"></a>
Per session 68 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,068 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 2 findings. Scan, not verified.
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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00068 $0.02068
Opus 5 $0.00034 $0.01034
Sonnet 5 $0.00014 $0.00414
Haiku 4.5 $0.00007 $0.00207

Measured 6d ago against content hash c5be05b2d04d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade B, and why

notion scanned grade B with 2 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 6d ago.

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.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

**Do NOT suggest editing `~/.claude/settings.local.json` manually.** The `teleport-setup add-key` command handles it with backup, validation, and masked input. Stop execution until the user has run the command and restar

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -sL -X POST -H "Authorization: Bearer $NOTION_API_KEY" \
skills/notion/SKILL.md · 123 lines

How it starts

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

Notion

Direct REST access to Notion pages, databases, blocks, and search — no MCP server. Use when the user wants the agent to query or mutate their workspace (e.g. a tasks DB). The hard part is the response shapes, not auth: property values are wrapped per-type and text is rich-text arrays, not strings.

Usage

  • Use for: Querying a database with filters, creating/updating pages, appending blocks to a page, workspace search.
  • Skip for: Static markdown exports, bulk imports of thousands of rows (script with real pagination), realtime sync/webhooks (API is pull-based).

Credentials check

[ -n "${NOTION_API_KEY:-${NOTION_TOKEN:-$NOTION_INTEGRATION_TOKEN}}" ] && echo "NOTION_API_KEY: PRESENT" || echo "NOTION_API_KEY: MISSING"

Never echo the variable directly — the value would appear in the conversation transcript. Use only the boolean pattern above.

If MISSING, respond to the user with EXACTLY this message (do NOT paraphrase, do NOT suggest manual JSON edits):

I need your notion credential. Run this in another terminal — it'll open the signup page, validate format, and save it safely with masked input:

teleport-setup add-key notion

Then restart Claude Code (/exit, then claude) and ask me again.

Do NOT suggest editing ~/.claude/settings.local.json manually. The teleport-setup add-key command handles it with backup, validation, and masked input. Stop execution until the user has run the command and restarted.

API

  • Base URL: https://api.notion.com/v1
  • Auth: Authorization: Bearer $NOTION_API_KEY
  • Notion-Version: 2026-03-11 header is REQUIRED — missing it returns 400 missing_version.
  • Content-Type: application/json on POST/PATCH.
  • Rate limit: ~3 req/s per integration; 429 rate_limited + Retry-After on excess. Payload caps: 500KB, 100 items per array, 2000 chars per rich-text object.
  • Permissions: auth alone is not enough. The integration must be explicitly shared with each page/database (page ••• → Connections → add integration). Unshared = 404 object_not_found.

Read the full file on GitHub · 123 lines

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.

  1. 6d ago First seen · 123 lines · 68 tokens per session scan B c5be05b2d04d

Subscribe to this mod's changes

notion is a skill published in the GitHub repository mnlt/teleport (8 stars, last pushed 4mo ago), licensed MIT. It adds 68 tokens to every session and 2,068 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it B with 2 findings (reads agent configuration directories, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

apple-notes-search

Search, recall, and discover connections across the user's own Apple Notes via the apple-notes MCP server — semantic + keyword search, Swanson-ABC bridges, entity threads, related-notes, and cited synthesis over everything they've ever written. Use AGGRESSIVELY whenever the user wants to find, recall, look up, or…

connerkward/mcp-apple-notes · 209 tokens

voice-note-ingest

Ingest a voice note with exact-phrasing preservation (never paraphrased). Routes content to originals/, concepts/, people/, companies/, ideas/, personal/, or voice-notes/ based on a decision tree. The user's exact words are the signal.

timurgaleev/memex · 56 tokens

orbit-notion

Open Orbit briefing skill — selected by the Orbit pipeline when Notion is the user's only connected connector, or when the user explicitly scopes their daily digest to Notion. Pulls the past 24 hours of document edits, comments, mentions, and database row changes from the user's authenticated Notion connection and…

nexu-io/open-design · 117 tokens

gog-drive

Google Drive operations through gog.

openclaw/gogcli · 10 tokens

gog-save-attachments

Gmail attachment download and Google Drive archival with gog.

openclaw/gogcli · 17 tokens

obsidian-cli

Interact with Obsidian vaults using the Obsidian CLI to read, create, search, and manage notes, tasks, properties, and more. Also supports plugin and theme development with commands to reload plugins, run JavaScript, capture errors, take screenshots, and inspect the DOM. Use when the user asks to interact with their…

breferrari/obsidian-mind · 102 tokens