KosmoKrator

productivity

Grist MCP Gateway for AI Agents

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

13 functions 9 read 4 write API key auth
Submit Grist feedback View package source

Grist MCP Gateway

Expose Grist to MCP clients with `kosmokrator mcp:serve --integration=grist`.

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=grist --write=deny --json
{
  "mcpServers": {
    "kosmokrator-grist": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=grist",
        "--write=deny"
      ]
    }
  }
}

Serve Manually

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

MCP Tool Names

KosmoKrator exposes integration tools through the gateway with stable names:

MCP Tool Names (13 tools)
MCP toolSource functionType
integration__grist__grist_list_workspaces grist.grist_list_workspaces Read read
integration__grist__grist_get_workspace grist.grist_get_workspace Read read
integration__grist__grist_list_docs grist.grist_list_docs Read read
integration__grist__grist_get_doc grist.grist_get_doc Read read
integration__grist__grist_list_tables grist.grist_list_tables Read read
integration__grist__grist_get_table grist.grist_get_table Read read
integration__grist__grist_list_records grist.grist_list_records Read read
integration__grist__grist_get_record grist.grist_get_record Read read
integration__grist__grist_create_records grist.grist_create_records Write write
integration__grist__grist_update_records grist.grist_update_records Write write
integration__grist__grist_delete_records grist.grist_delete_records Write write
integration__grist__grist_create_column grist.grist_create_column Write write
integration__grist__grist_list_columns grist.grist_list_columns 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.