notion

Query and write to a Notion workspace.

The notion command can search accessible pages, inspect databases, create pages, append Markdown as blocks, update database rows, and answer natural-language questions with clanker notion ask.

Usage

clanker notion [command]

Alias: nt

Authentication

notion:
  integration_token: ""
  default_database_id: ""

Environment variables:

Variable	Description
NOTION_API_KEY	Internal integration token
NOTION_DATABASE_ID	Optional default database ID

Notion integrations start with no page access. Share each page or database with the integration from the Notion UI under ... > Connections before expecting search or database results.

Commands

Command	Description
ask	Ask natural-language questions about accessible pages and databases
list	List pages, databases, or users
get	Get a page, database, blocks, or user
search	Search page and database titles across accessible workspace content
page create	Create a page under a parent page or database
page append	Append Markdown content to an existing page
db row create	Create a row in a database using Notion property JSON
db row update	Patch a row's properties

Examples

clanker notion search "prod runbook"
clanker notion list databases
clanker notion get page <page-id>
clanker notion page create --parent <page-id> --title "Incident Notes" --text "## Summary"
clanker notion page append --page <page-id> --markdown incident.md

Natural-language knowledge-base queries:

clanker notion ask "where is the prod-RDS-snapshot policy?"
clanker notion ask "what databases track incidents?"
clanker notion ask "summarize our last 5 runbooks"

MCP

The MCP server exposes Notion tools for ask, search, page/block reads, database queries, page creation, appends, page property updates, and database row creation. See mcp.