Can I use Notion as a CLI?

Yes. KosmoKrator exposes a Notion CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Notion through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Notion tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Notion credentials stored?

Notion credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Notion MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Notion CLI for Headless Automation

Use the Notion CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 6 read 1 write Bearer token auth

Submit Notion feedback View package source

Notion CLI for Headless Automation

Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.

Use headless automation when another tool needs a stable local command surface. The Notion CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Notion CLI for Headless Automation
kosmokrator integrations:configure notion2 --set access_token="$NOTION2_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call notion2.notion2_list_pages '{"query":"example_query","filter":"example_filter","sort":"example_sort","start_cursor":"example_start_cursor","page_size":1}' --json

Discovery Before Execution

Agents and scripts can inspect Notion docs and schemas before choosing a function.

kosmo integrations:docs notion2 --json
kosmo integrations:docs notion2.notion2_list_pages --json
kosmo integrations:schema notion2.notion2_list_pages --json
kosmo integrations:search "Notion" --json
kosmo integrations:list --json

Useful Notion CLI Functions

Function	Type	Parameters	Description
`notion2.notion2_list_pages`	Read	query, filter, sort, start_cursor, page_size	Search and list pages in your Notion workspace.
`notion2.notion2_get_page`	Read	page_id	Get detailed information about a Notion page.
`notion2.notion2_create_page`	Write	parent, properties, children, icon, cover	Create a new page in Notion.
`notion2.notion2_list_databases`	Read	query, sort, start_cursor, page_size	List databases in your Notion workspace.
`notion2.notion2_query_database`	Read	database_id, filter, sorts, start_cursor, page_size	Query a Notion database with optional filters.
`notion2.notion2_list_users`	Read	start_cursor, page_size	List all users in your Notion workspace.
`notion2.notion2_get_current_user`	Read	none	Get the currently authenticated Notion user/bot.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Notion CLI Pages

CI Notion CLI for CI. Cron Jobs Notion CLI for cron jobs. Shell Scripts Notion CLI for shell scripts. Coding Agents Notion CLI for coding agents.