How do I install the Notion 2 skill?

Run npx skillmds add sundial-org/notion-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Notion 2 skill do?

Work with Notion pages and databases via the official Notion API. It is listed under Integrations & APIs on SkillMD.

Is Notion 2 safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Notion 2?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Notion 2 free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Notion 2?

sundial-org (@sundial-org) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Notion 2 by sundial-org — Agent Skill

Name: Notion 2
Rating: 4.2 (5 reviews)
Author: sundial-org

File contents

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.

---name: notion-2description: Work with Notion pages and databases via the official Notion API.--- # 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: ```bash 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: ```bash export NOTION_PROFILE=work ``` ## Pages **Read page:** ```bash notion-cli page get <page_id> ``` **Append blocks:** ```bash notion-cli block append <page_id> --markdown "..." ``` Prefer appending over rewriting content. **Create page:** ```bash notion-cli page create --parent <page_id> --title "..." ``` ## Databases **Inspect schema:** ```bash notion-cli db get <database_id> ``` **Query database:** ```bash notion-cli db query <database_id> --filter <json> --sort <json> ``` **Create row:** ```bash notion-cli page create --database <database_id> --props <json> ``` **Update row:** ```bash 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: ```bash 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.

Frequently asked questions