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

hljs language-bash

bunx nooon

Manual Install (Pre-built binaries)

Download from Releases:

hljs language-bash

# 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

Authentication

Choose one of the following methods:

API Token (Simple)

hljs language-bash

export NOTION_TOKEN=ntn_xxx

OAuth (Interactive)

hljs language-bash

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

Get credentials from Notion Integrations.

Usage

hljs language-bash

eval $(bunx nooon mcp install)

Check status:

hljs language-bash

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

hljs language-css

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

hljs language-bash

bun install
bun run compile

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

hljs language-bash

NOTION_CLIENT_ID=xxx NOTION_CLIENT_SECRET=xxx bun run compile

License

MIT

nooon

nooon

Features

Installation

Authentication

Usage

MCP Tools

CLI Reference

Building from Source

License

Similar Packages

Tags

Original Author

Publisher