ahel
Start free

Notion Integration

SkillDocs & knowledge

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

Available today. Use it from your connected AI after setup.

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

Then ask your AI: use the Notion Integration skill

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

FunctionDescription
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
613
Last commit
Sep 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

More in Docs & knowledge

canvas-design
Skill · anthropicsdoc-coauthoring
Skill · anthropicstheme-factory
Skill · anthropicsspec-driven-development
Skill · addyosmanidefuddle
Skill · kepanoagent-architecture-audit
Skill · affaan-m