KosmoKrator

productivity

Coda MCP Integration for OpenAI Agents SDK

Connect Coda to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

12 functions 9 read 3 write API token auth
Submit Coda feedback View package source

Connect Coda to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Coda MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

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

Run the Gateway Manually

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

Why Use KosmoKrator Here

Scoped tools

Expose only Coda instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Coda Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Coda integration catalog.

MCP toolSource functionTypeDescription
integration__coda__coda_list_docs coda.coda_list_docs Read List Coda docs accessible to the authenticated user. Optionally filter by name or ownership.
integration__coda__coda_get_doc coda.coda_get_doc Read Get details of a specific Coda doc by its ID.
integration__coda__coda_list_tables coda.coda_list_tables Read List tables in a Coda doc. Returns table IDs, names, and display types.
integration__coda__coda_get_table coda.coda_get_table Read Get details of a specific table in a Coda doc, including its columns and display column.
integration__coda__coda_list_rows coda.coda_list_rows Read List rows in a Coda table. Use useColumnNames=true to get values keyed by human-readable column names instead of column IDs.
integration__coda__coda_get_row coda.coda_get_row Read Get a single row from a Coda table by its row ID.
integration__coda__coda_insert_rows coda.coda_insert_rows Write Insert one or more new rows into a Coda table. Each row should have a "cells" array with column/value pairs.
integration__coda__coda_update_row coda.coda_update_row Write Update cells in an existing row in a Coda table. Provide a cells array with column/value pairs to update.
integration__coda__coda_delete_row coda.coda_delete_row Write Delete a row from a Coda table. This action is permanent.
integration__coda__coda_list_columns coda.coda_list_columns Read List columns in a Coda table. Useful to discover column names and types before querying or inserting rows.
integration__coda__coda_list_pages coda.coda_list_pages Read List pages in a Coda doc. Pages can contain text, tables, and other content.
integration__coda__coda_get_current_user coda.coda_get_current_user Read Verify Coda authentication and get the current user's profile information.

Related Coda Pages

Coda CLIUse direct JSON commands instead of MCP discovery. Coda MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.