notion-2
Provides command-line interface access for reading, creating, and updating Notion content.
Install
mkdir -p .claude/skills/notion-2 && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/11449" && unzip -o skill.zip -d .claude/skills/notion-2 && rm skill.zipInstalls to .claude/skills/notion-2
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Work with Notion pages and databases via the official Notion API.Key capabilities
- →Read Notion pages by ID
- →Append blocks to Notion pages using markdown
- →Create new Notion pages with parent and title
- →Query Notion databases with filters and sorts
- →Create new rows in Notion databases with properties
How it works
The skill interacts with the Notion API via a local CLI (`notion-cli`), performing operations like reading pages, appending blocks, querying databases, and creating/updating rows based on user commands.
Inputs & outputs
When to use notion-2
- →Query notion database
- →Append to notion page
- →Update database records
About this skill
Notion
This skill lets the agent work with Notion pages and databases using the official Notion API.
The skill is declarative: it documents safe, recommended operations and assumes a local CLI
(notion-cli) that actually performs API calls.
Authentication
- Create a Notion Integration at https://www.notion.so/my-integrations
- Copy the Internal Integration Token.
- Export it as:
export NOTION_API_KEY=secret_xxx
Share the integration with the pages or databases you want to access. Unshared content is invisible to the API.
Profiles (personal / work)
You may define multiple profiles (e.g. personal, work) via env or config.
Default profile: personal
Override via:
export NOTION_PROFILE=work
Pages
Read page:
notion-cli page get <page_id>
Append blocks:
notion-cli block append <page_id> --markdown "..."
Prefer appending over rewriting content.
Create page:
notion-cli page create --parent <page_id> --title "..."
Databases
Inspect schema:
notion-cli db get <database_id>
Query database:
notion-cli db query <database_id> --filter <json> --sort <json>
Create row:
notion-cli page create --database <database_id> --props <json>
Update row:
notion-cli page update <page_id> --props <json>
Schema changes (advanced)
Always inspect diffs before applying schema changes.
Never modify database schema without explicit confirmation.
Recommended flow:
notion-cli db schema diff <database_id> --desired <json>
notion-cli db schema apply <database_id> --desired <json>
Safety notes
- Notion API is rate-limited; batch carefully.
- Prefer append and updates over destructive operations.
- IDs are opaque; store them explicitly, do not infer from URLs.
When not to use it
- →When the user wants to perform destructive operations without careful consideration
- →When the user wants to infer Notion IDs from URLs
Prerequisites
Limitations
- →Notion API is rate-limited
- →IDs are opaque; store them explicitly, do not infer from URLs
- →Never modify database schema without explicit confirmation
How it compares
This skill provides a declarative, CLI-based interface for Notion API interactions, simplifying common tasks like page and database management compared to direct API calls or manual Notion UI operations.
Compared to similar skills
notion-2 side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| notion-2 (this skill) | 0 | 6mo | Review | Intermediate |
| word | 26 | 9mo | Review | Beginner |
| notion-knowledge-capture | 10 | 9mo | No flags | Intermediate |
| apple-reminders | 25 | 2mo | Review | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by sundial-org
View all by sundial-org →You might also like
word
Fergana-Labs
Create, read, edit, and manipulate Microsoft Word documents (.docx files). Use when users ask to work with Word files, create documents, read .docx files, or format text documents.
notion-knowledge-capture
makenotion
Transforms conversations and discussions into structured documentation pages in Notion. Captures insights, decisions, and knowledge from chat context, formats appropriately, and saves to wikis or databases with proper organization and linking for easy discovery.
apple-reminders
openclaw
Manage Apple Reminders via the `remindctl` CLI on macOS (list, add, edit, complete, delete). Supports lists, date filters, and JSON/plain output.
memory-keeper-proactive-context-maintenance
b4CU-R4U
Automatically detect and maintain memory freshness by monitoring context staleness, significant code changes, task completions, and phase transitions. Proactively suggests and executes memory sync operations with user confirmation. Use when the user says "sync memory", "update context", or when the Skill detects that context is stale (>2 hours), significant changes have occurred (new commits), tasks completed, or major milestones reached. Replaces passive "context is stale" warnings with active maintenance.
youtube-clipper
op7418
YouTube 视频智能剪辑工具。下载视频和字幕，AI 分析生成精细章节（几分钟级别）， 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频，并生成总结文案。 使用场景：当用户需要剪辑 YouTube 视频、生成短视频片段、制作双语字幕版本时。 关键词：视频剪辑、YouTube、字幕翻译、双语字幕、视频下载、clip video
obsidian-bases
kepano
Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries. Use when working with .base files, creating database-like views of notes, or when the user mentions Bases, table views, card views, filters, or formulas in Obsidian.