nooon

Lightweight, read-only Notion MCP Server optimized for token efficiency.

Features

• Simple auth with NOTION_TOKEN or OAuth 2.0 + PKCE
• Minimal output using TOON format
• Smart caching based on last_edited_time
• Recursive block fetching in a single call

Installation

bunx nooon

<details> <summary>Manual Install (Pre-built binaries)</summary>

Download from Releases:

# macOS (Apple Silicon)
curl -L https://github.com/corrupt952/nooon/releases/latest/download/nooon-darwin-arm64 -o nooon && chmod +x nooon

# macOS (Intel)
curl -L https://github.com/corrupt952/nooon/releases/latest/download/nooon-darwin-x64 -o nooon && chmod +x nooon

# Linux (x64)
curl -L https://github.com/corrupt952/nooon/releases/latest/download/nooon-linux-x64 -o nooon && chmod +x nooon

# Linux (arm64)
curl -L https://github.com/corrupt952/nooon/releases/latest/download/nooon-linux-arm64 -o nooon && chmod +x nooon

</details>

Authentication

Choose one of the following methods:

API Token (Simple)

export NOTION_TOKEN=ntn_xxx

OAuth (Interactive)

bunx nooon config --client-id <id> --client-secret <secret>
bunx nooon auth

Get credentials from Notion Integrations.

Usage

Register with Claude Code:

eval $(bunx nooon mcp install)

Check status:

bunx nooon status

MCP Tools

Tool	Description
nooon_search	Search pages and databases by keyword
nooon_page	Get page content with nested blocks (cached)
nooon_database	Get database schema and available views
nooon_data_source	Get data source schema (property definitions)
nooon_query	Query database with filter/sort
nooon_clear_cache	Clear cached pages

CLI Reference

bunx nooon auth              Start OAuth flow
bunx nooon logout            Clear credentials
bunx nooon status            Show auth status
bunx nooon config            Configure OAuth credentials
bunx nooon cache clear       Clear page cache
bunx nooon mcp               Start MCP server
bunx nooon mcp install       Output claude mcp add command
bunx nooon mcp config        Output mcpServers JSON

Building from Source

bun install
bun run compile

For team distribution (users only need to run bunx nooon auth, no integration setup required):

NOTION_CLIENT_ID=xxx NOTION_CLIENT_SECRET=xxx bun run compile

License

MIT