Nby Notion
Description
The API matches the titles of pages and data sources the token can reach; `notion-search` also searches page content and, with Notion AI, connected sources.
search-workspace.md
Search the workspace
Finds pages and data sources that match a query.
The API matches the titles of pages and data sources the token can reach; notion-search also searches page content and, with Notion AI, connected sources.
Set up
Use the first option your agent supports.
MCP (official, remote)
Add this server to your agent's MCP settings, then sign in when asked.
{ "mcpServers": { "notion": { "url": "https://mcp.notion.com/mcp" } } }
Call the MCP tool notion-search.
Server URL: https://mcp.notion.com/mcp
CLI (official)
Install the command, then confirm it runs.
npm install --global ntn
ntn --version
Run ntn api v1/search.
Set $NOTION_API_TOKEN in your environment first (get a key: https://www.notion.so/developers/tokens).
API (official)
- Base URL: https://api.notion.com
- Endpoint:
POST /v1/search - Auth: send the header
Authorization: Bearer $NOTION_API_KEY - Get a key: https://www.notion.so/developers/tokens
- Docs: https://developers.notion.com/reference/intro
Before doing anything else, make one read-only call to confirm access.
Rules
- Ask the user before anything that sends messages, costs money, or changes data.
- Never print API keys.
Built from these files in the repository
The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.