How do I install the Notion skill?

Run npx skillmds@latest add builderio/notion 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 skill do?

Access the Notion content calendar and page data for editorial planning. Use this skill when the user asks about the content calendar, blog planning, or editorial schedule. It is listed under Data & Analytics on SkillMD.

Is Notion safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Notion?

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 free to use?

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

Who published Notion?

Builder.io (@builderio) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Notion by builderio — Agent Skill

Name: Notion
Author: Builder.io

File contents

Notion Integration

Connection

Base URL: https://api.notion.com/v1
Auth: Authorization: Bearer $NOTION_API_KEY, Notion-Version: 2022-06-28
Env vars: NOTION_API_KEY
Caching: 10-minute cache for content calendar and individual pages
Content DB: db4ae46c822443ba96e51a6a352e0fbe (hard-coded)

Server Lib

File: server/lib/notion.ts

Exported Functions

Function	Description
`getContentCalendar()`	Fetch all entries from the content calendar database
`getNotionPage(pageId)`	Fetch a page with its block content (recursive)
`getContentCalendarSchema()`	Get the database schema/properties

Agent Actions

content-calendar — fetch content calendar entries
content-calendar-schema — fetch the database schema/properties
notion-page --pageId <id> — fetch a page with block content

Do not call /api/notion/* directly from the agent.

Key Patterns & Gotchas

Content calendar paginates via POST /databases/:id/query with page_size: 100 and start_cursor
extractProp handles all Notion property types (title, rich_text, select, multi_select, date, people, rollup, formula, etc.)
fetchBlocks recurses to fetch children when has_children is true — can be expensive for deeply nested pages
Database ID and API version are hard-coded

Frequently asked questions

Notion