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 MCP, CLI, and Lua Integration for AI Agents

Notion integration docs for AI agents: MCP gateway setup, Notion CLI commands, Lua API reference, credentials, and function schemas.

7 functions 6 read 1 write Bearer token auth

Submit Notion feedback View package source

Notion for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: notion2
route_slug: notion2
package: notion2
auth_strategy: bearer_token Bearer token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Notion CLIHeadless setup and direct function calls. Notion MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Notion MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Notion.

Claude Code Notion MCP setup for Claude Code. Cursor Notion MCP setup for Cursor. Codex Notion MCP setup for Codex. OpenAI Agents Notion MCP setup for OpenAI Agents SDK. Claude Agent SDK Notion MCP setup for Claude Agent SDK. Vercel AI SDK Notion MCP setup for Vercel AI SDK. LangChain Notion MCP setup for LangChain. LangGraph Notion MCP setup for LangGraph. CrewAI Notion MCP setup for CrewAI. MCP clients Notion MCP setup for Generic MCP Clients.

Notion CLI Matrix

Use these pages for direct Notion CLI workflows in scripts, CI, cron, and agent wrappers.

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

Function Catalog

Function	Type	Parameters	Description
`notion2.notion2_list_pages`	Read `read`	5	Search and list pages in your Notion workspace.
`notion2.notion2_get_page`	Read `read`	1	Get detailed information about a Notion page.
`notion2.notion2_create_page`	Write `write`	5	Create a new page in Notion.
`notion2.notion2_list_databases`	Read `read`	4	List databases in your Notion workspace.
`notion2.notion2_query_database`	Read `read`	5	Query a Notion database with optional filters.
`notion2.notion2_list_users`	Read `read`	2	List all users in your Notion workspace.
`notion2.notion2_get_current_user`	Read `read`	0	Get the currently authenticated Notion user/bot.