npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@feniix/pi-notion

v3.0.1

Published

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

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

feniixfeniix

Keywords

pipi-packagepi-extensionpi-coding-agentainotionproductivity

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