@feniix/pi-notion

Notion API extension for pi — read, search, and manage Notion pages, databases, and content

Package details

← Back
extensionskill

Install @feniix/pi-notion from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@feniix/pi-notion
Package
@feniix/pi-notion
Version
2.2.2
Published
Apr 22, 2026
Downloads
4,812/mo · 300/wk
Author
feniix
License
MIT
Types
extension, skill
Size
95.3 KB
Dependencies
3 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./extensions/index.ts",
    "./extensions/mcp-client.ts"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@feniix/pi-notion

Notion MCP extension for pi — connect to Notion via OAuth and use Notion's official MCP tools.

Features

  • MCP OAuth Connect: Connect to Notion's official MCP server
  • Dynamic Tool Registration: Auto-discovers and registers available Notion MCP tools after connect
  • Connection Management: Connect, disconnect, and check status via tools or /notion
  • Guardrails: Advisory warnings for common Notion tool mistakes

Install

pi install npm:@feniix/pi-notion

Ephemeral (one-off) use:

pi -e npm:@feniix/pi-notion

Setup (Recommended)

This package is MCP-first and uses Notion's hosted MCP endpoint:

  • MCP URL: https://mcp.notion.com/mcp
  • Auth: OAuth in browser

Connect

Either run:

/notion

or call:

  • notion_mcp_connect

Check status

  • notion_mcp_status

Disconnect

  • notion_mcp_disconnect

Tools

Always available

Tool Description
notion_mcp_connect Connect to Notion MCP server via OAuth
notion_mcp_disconnect Disconnect and clear stored MCP config
notion_mcp_status Show current MCP connection status

After connecting

Notion MCP tools are discovered from the server and registered dynamically.

Use notion_mcp_status to list currently available tools.

Authentication Notes

This package requires MCP OAuth (/notion or notion_mcp_connect) for tool connectivity.

Session-start status checks for:

  1. MCP OAuth config (~/.pi/agent/notion-mcp-auth.json, or NOTION_MCP_AUTH_FILE / --notion-mcp-auth-file if explicitly set)
  2. Legacy OAuth token files under ~/.pi/agent/extensions/
  3. Legacy direct API token hints (NOTION_API_KEY, NOTION_TOKEN) and warns that MCP OAuth is still required.

Best practice: use settings.json for non-secret defaults only. Keep Notion credentials in a dedicated private file (by default ~/.pi/agent/notion-mcp-auth.json) or in environment variables. If you want to move the auth file, set NOTION_MCP_AUTH_FILE or pass --notion-mcp-auth-file with a custom file path. Legacy aliases NOTION_MCP_AUTH and --notion-mcp-auth are still accepted but deprecated.

For the legacy direct-token compatibility config path, prefer NOTION_CONFIG_FILE / --notion-config-file. Legacy aliases NOTION_CONFIG and --notion-config are still accepted but deprecated.

Do not store tokens or client secrets in settings.json.

Requirements

  • pi v0.51.0 or later

License

MIT