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 Gateway for AI Agents

Expose Notion tools to Claude Code, Cursor, Codex, and other MCP clients through the local KosmoKrator MCP gateway.

20 functions 11 read 9 write API key auth

Submit Notion feedback View package source

Notion MCP Gateway

Expose Notion to MCP clients with `kosmokrator mcp:serve --integration=notion`.

If the client has never used KosmoKrator before, install it first, then register this integration as a stdio MCP server. The gateway exposes only the selected integration in the example below.

curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

kosmokrator mcp:gateway:install --integration=notion --write=deny --json

{
  "mcpServers": {
    "kosmokrator-notion": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=notion",
        "--write=deny"
      ]
    }
  }
}

Serve Manually

kosmokrator mcp:serve --integration=notion --write=deny

MCP Tool Names

KosmoKrator exposes integration tools through the gateway with stable names:

MCP Tool Names (20 tools)

MCP tool	Source function	Type
`integration__notion__notion_search`	`notion.notion_search`	Read `read`
`integration__notion__notion_create_page`	`notion.notion_create_page`	Write `write`
`integration__notion__notion_get_page`	`notion.notion_get_page`	Read `read`
`integration__notion__notion_update_page`	`notion.notion_update_page`	Write `write`
`integration__notion__notion_archive_page`	`notion.notion_archive_page`	Write `write`
`integration__notion__notion_create_database`	`notion.notion_create_database`	Write `write`
`integration__notion__notion_get_database`	`notion.notion_get_database`	Read `read`
`integration__notion__notion_update_database`	`notion.notion_update_database`	Write `write`
`integration__notion__notion_query_database`	`notion.notion_query_database`	Read `read`
`integration__notion__notion_list_databases`	`notion.notion_list_databases`	Read `read`
`integration__notion__notion_get_block_children`	`notion.notion_get_block_children`	Read `read`
`integration__notion__notion_append_block_children`	`notion.notion_append_block_children`	Write `write`
`integration__notion__notion_get_block`	`notion.notion_get_block`	Read `read`
`integration__notion__notion_update_block`	`notion.notion_update_block`	Write `write`
`integration__notion__notion_delete_block`	`notion.notion_delete_block`	Write `write`
`integration__notion__notion_get_current_user`	`notion.notion_get_current_user`	Read `read`
`integration__notion__notion_list_users`	`notion.notion_list_users`	Read `read`
`integration__notion__notion_get_user`	`notion.notion_get_user`	Read `read`
`integration__notion__notion_create_comment`	`notion.notion_create_comment`	Write `write`
`integration__notion__notion_get_comments`	`notion.notion_get_comments`	Read `read`

Write Access

Start with --write=deny for read-only MCP clients. Use --write=ask or --write=allow only when the client and workspace are trusted.