KosmoKrator

productivity

Podio MCP Integration for LangGraph

Connect Podio to LangGraph 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 LangGraph

Run KosmoKrator integration calls from LangGraph nodes while preserving local credentials and permissions.

Use a graph node that calls the KosmoKrator CLI for deterministic steps or an MCP client for dynamic tool selection. The gateway is local, scoped to this integration, and starts with --write=deny so LangGraph can inspect read-capable tools without receiving write access by default.

Podio MCP Config for LangGraph

Headless CLI calls fit repeatable graph edges; MCP fits exploratory agent nodes.

{
  "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 LangGraph

LangGraph 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 LangGraphClient-level gateway setup.