agentmods.dev

notion-cli

notion-cli is a skill for Claude Code, Codex from glide-the/im-dream. It costs 105 tokens per session (783 once invoked), scanned A, original, MIT.

A command-line assistant for searching, reading, and querying connected Notion pages and databases. Notion is a workspace for documents, notes, tasks, and structured team data.

In plain words
What is it for?
Finding Notion content, reading pages as Markdown, viewing database records, and checking the connected workspace before making queries.
Why use it?
It avoids manually browsing the Notion interface when the needed information is already connected to the project. It also provides a defined way to inspect synced pages and databases.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

not rated 0repo yesterday A scan 105 tokens original MIT

Good fit Finding Notion content, reading pages as Markdown, viewing database records, and checking the connected workspace before making queries.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/glide-the/im-dream/notion-cli
View source ↗ glide-the/im-dream
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 glide-the/im-dream --skill notion-cli
Clone the repo
git clone --depth 1 https://github.com/glide-the/im-dream

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-cli

README.md
[![agentmods](https://agentmods.dev/badge/skills/glide-the/im-dream/notion-cli/github.svg)](https://agentmods.dev/skills/glide-the/im-dream/notion-cli)
Your own site
<a href="https://agentmods.dev/skills/glide-the/im-dream/notion-cli"><img src="https://agentmods.dev/badge/skills/glide-the/im-dream/notion-cli/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.

agentmods 80×15 button for notion-cli

Your own site · 80×15
<a href="https://agentmods.dev/skills/glide-the/im-dream/notion-cli"><img src="https://agentmods.dev/badge/skills/glide-the/im-dream/notion-cli.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 105 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 783 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.

ModelPer sessionOnce invoked
Fable 5.1 $0.00105 $0.00783
Opus 5.5 $0.00042 $0.00313
Sonnet 5.5 $0.00021 $0.00157
Haiku 4.5 $0.00011 $0.00078

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

Security

Grade A, and why

notion-cli 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 12d 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.

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.

backend/builtin_skills/notion/notion-cli/SKILL.md · 86 lines

What it actually says

Notion CLI 工作空间数据助手

概述

通过 ntn api CLI 访问用户已连接的 Notion 资源连接器数据。CLI 自动处理 Authorization 和 Notion-Version 请求头，无需手动配置。

前置条件

  • 工作空间已创建 Notion 资源连接器（.notion/ 目录存在）
  • NOTION_HOME 环境变量已配置
  • ntn CLI 已安装且已认证

工作流

1. 了解连接器状态

进入对话时，先检查 .notion/connector.json 获取已连接的 Database 和 Page 信息：

cat .notion/connector.json

2. 浏览已同步数据

# 查看所有已同步页面索引
cat .notion/index.json

# 查看某个 Database 的页面清单
cat .notion/databases/<database_id>.json

3. 按需调用 Notion API

根据用户需求选择对应操作：

需求 操作 参考文档
搜索内容 ntn api v1/search references/notion-search.md
读取页面 ntn api v1/pages/<id>/markdown references/notion-page-read.md
查询数据库 ntn api v1/databases/<id>/query references/notion-db-query.md

核心命令速查

搜索

ntn api v1/search --data '{"query":"<关键词>","page_size":10}'

读取页面（Markdown 格式，推荐）

ntn api v1/pages/<page_id>/markdown

查询数据库

ntn api v1/databases/<database_id>/query --data '{}'

参考文档

当需要高级用法（筛选、排序、分页等）时，阅读对应参考文档：

  • references/notion-search.md — 搜索 API 完整用法（关键词搜索、按类型筛选、排序、分页）
  • references/notion-page-read.md — 页面读取完整用法（元信息、Markdown、Block 结构）
  • references/notion-db-query.md — 数据库查询完整用法（筛选条件、复合筛选、排序、属性类型参考）

注意事项

  • ntn api 自动添加 Auth 和 Version 头，无需手动设置
  • 搜索 API 仅支持标题匹配，不支持正文全文搜索
  • 单次查询最大 page_size 为 100，超过需分页
  • 页面 ID 可从 .notion/index.json、.notion/databases/<db_id>.json 或搜索结果中获取
  • filter 中的 property 值必须与 Database Schema 中的属性名完全匹配（区分大小写）
Files

What ships with it

4 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.

  1. 12d ago First seen · 86 lines · 105 tokens per session scan A d40c68636671

Subscribe to this mod's changes

notion-cli is a skill published in the GitHub repository glide-the/im-dream (0 stars, last pushed yesterday), licensed MIT. It adds 105 tokens to every session and 783 once invoked, about $0.0004 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-10-02.

DocumentsProject management
Related

Other skills, from other repositories

notion

Notion CLI/API for pages, Markdown content, data sources, files, comments, search, Workers, and raw API calls.

openclaw/openclaw · 29 tokens

notion

Search, read, create, and update Notion pages via the Notion MCP.

asgeirtj/system_prompts_leaks · 20 tokens

recipe-create-doc-from-template

Copy a Google Docs template, fill in content, and share with collaborators.

googleworkspace/cli · 21 tokens

prismer-notion

Notion API + ntn CLI: pages, databases, markdown, Workers.

Prismer-AI/PrismerCloud · 21 tokens

google-workspace-ops

Operate across Google Drive, Docs, Sheets, and Slides as one workflow surface for plans, trackers, decks, and shared documents. Use when the user needs to find, summarize, edit, migrate, or clean up Google Workspace assets without dropping to raw tool calls.

hashgraph-online/awesome-codex-plugins · 59 tokens

sred-project-organizer

Take a list of projects and their related documentation, and organize them into the SRED format for submission.

getsentry/skills · 27 tokens