KosmoKrator

productivity

Podio MCP Integration for Claude Agent SDK

Connect Podio to Claude Agent SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 7 read 0 write Manual OAuth token auth
Submit Podio feedback View package source

Connect Podio to Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

Podio MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

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

Run the Gateway Manually

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

Why Use KosmoKrator Here

Scoped tools

Expose only Podio 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.

Podio Tools Visible to Claude Agent SDK

Claude Agent SDK sees stable MCP tool names generated from the Podio integration catalog.

MCP toolSource functionTypeDescription
integration__podio__podio_list_spaces podio.podio_list_spaces Read List all workspaces (spaces) in a Podio organization. Returns space IDs, names, URLs, and membership details. Use this to discover available workspaces before exploring their apps and items.
integration__podio__podio_get_space podio.podio_get_space Read Get detailed information about a specific Podio workspace, including its name, description, URL, and settings. Use the space ID obtained from podio_list_spaces.
integration__podio__podio_list_apps podio.podio_list_apps Read List all apps in a Podio workspace. Returns app IDs, names, item counts, and configuration. Use this to discover available apps before querying their items.
integration__podio__podio_get_app podio.podio_get_app Read Get detailed information about a specific Podio app, including its field definitions, layout, and configuration. Use this to understand the data structure before listing or filtering items.
integration__podio__podio_list_items podio.podio_list_items Read List and filter items in a Podio app. Supports filtering by field values, sorting, and pagination. Use podio_get_app first to understand the available fields for filtering.
integration__podio__podio_get_item podio.podio_get_item Read Get detailed information about a specific Podio item, including all field values, references, and metadata. Use the item ID obtained from podio_list_items.
integration__podio__podio_get_current_user podio.podio_get_current_user Read Get the status of the currently authenticated Podio user, including profile information, active organization memberships, and account details.

Related Podio Pages

Podio CLIUse direct JSON commands instead of MCP discovery. Podio MCPFull gateway reference and MCP tool names. KosmoKrator for Claude Agent SDKClient-level gateway setup.