pi-notion

Notion integration for Pi Coding Agent — search, fetch, create, and update Notion pages as Markdown.

Installation

pi install npm:pi-notion

Features

Tools

Tool	Description
notion_search	Search pages and databases by title
notion_fetch	Fetch a page by ID, convert blocks to Markdown, save as .md
notion_create	Create a new page from Markdown content
notion_update	Replace a page's content with new Markdown
notion_databases	List or query Notion databases

TUI Config Editor

Run /notion-config inside Pi to interactively set your API token and options — no JSON editing needed.

Bi-directional Markdown ↔ Notion Blocks

• Notion → Markdown: Headings, lists, code blocks, tables, callouts, toggles, images, bookmarks, equations, and more
• Markdown → Notion: Headings, lists, code blocks, quotes, checkboxes, images, dividers
• YAML frontmatter with page metadata (ID, URL, timestamps)

Configuration

Credentials are loaded from (in priority order):

1. .pi/notion.json (project-local)
2. ~/.pi/agent/notion.json (global)
3. Environment variables: NOTION_API_TOKEN, NOTION_OUTPUT_DIR

Config format

{
  "apiToken": "ntn_xxxxx",
  "outputDir": "./notion-docs",
  "notionVersion": "2022-06-28"
}

You can reference environment variables with the ENV: prefix:

{
  "apiToken": "ENV:NOTION_API_TOKEN",
  "outputDir": "./notion-docs"
}

Setup

1. Create an integration at https://www.notion.so/my-integrations
2. Copy the Internal Integration Secret (ntn_...)
3. Share pages/databases with your integration in Notion (⋯ → Connections → Add)
4. Run /notion-config in Pi or create the config file manually

Usage Examples

> Search my workspace for API docs
  → notion_search query="API docs"

> Download the onboarding guide
  → notion_fetch pageId="abc123-def456"

> Create a meeting notes page
  → notion_create parentPageId="..." title="Sprint Review 2025-03" content="## Highlights\n- ..."

> Update the runbook
  → notion_update pageId="..." content="## Updated Runbook\n..."

> List all databases
  → notion_databases action="list"

> Query a task tracker
  → notion_databases action="query" databaseId="..."

License

MIT