CLI Documentation

This page is the entrypoint for the nilo command-line interface. Commands are split by topic so page, block, database, configuration, and advanced fallback commands stay easy to scan.

Start Here

• Installation: install the nilo command.
• Uninstallation: uninstall the command and clean MCP client configuration, local token configuration, and project context.
• Configuration: prepare Notion access, save the token, and create project-local context.
• MCP Clients: connect MCP-compatible tools to the local N.I.L.O. server.
• Troubleshooting: diagnose common local and Notion API issues.

CLI Sections

• Overview: global rules, JSON payloads, --dry-run, and aliases.
• Project Config: init, pwd, version, and config --global/--local.
• Page: attach a default page, read pages and blocks, create pages, and update pages.
• Block: append, insert-after, update, and trash block content.
• Database DataSource: database containers, data source operations, and database shortcuts.
• Auth And User: token validation, whoami, and user lookup.
• Comments: list, create, and reply to comments.
• Views: retrieve, list, query, create, and update views.
• File Uploads: file upload lifecycle commands.
• Search And Custom Emoji: workspace search and custom emoji lookup.
• Raw API: advanced Raw API fallback.
• MCP Server: start, stop, inspect, and clean the local MCP server.

Common First Steps

nilo config --global user.token ntn_xxx
nilo config --global --show
nilo init --project-name "Demo"
nilo page attach <page_id>
nilo page retrieve
nilo page blocks