Notion Integration

SkillDocs & knowledge

This notion skill lets your agent read your Notion content calendar and page contents.

Use Notion Integration in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Notion Integration and connect your AI. About a minute.

Claude ChatGPT Ahel Desktop

Also: Claude Code · Cursor · Codex

Then ask your AI: use the Notion Integration skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.

No other account needed.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Notion IntegrationStart free

About this skill

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.

What this skill tells your AI

The instructions your AI receives, as published by builderio/agent-native in templates/analytics/.builder/skills/notion/SKILL.md and read by ahel’s review.

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

Signals

GitHub stars: 7k
Forks: 635
Last commit: Oct 2026

ahel review

S4info
community integration, published by builderio, not notion

Automated review, not a security audit. Ruleset v1+k2.

Advanced

Item type: skill
Key: notion-builderio
Source: github.com/builderio/agent-native

github.com/builderio/agent-native