Can I use Podio as a CLI?

Yes. KosmoKrator exposes a Podio CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Podio through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Podio tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Podio credentials stored?

Podio credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Podio MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Podio CLI for AI Agents

Use the Podio CLI from KosmoKrator to call Podio tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

7 functions 7 read 0 write Manual OAuth token auth

Submit Podio feedback View package source

Podio CLI Setup

Podio can be configured headlessly with `kosmokrator integrations:configure podio`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure podio --set access_token="$PODIO_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor podio --json
kosmokrator integrations:status --json

Credentials

Authentication type: Manual OAuth token oauth2_manual_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`access_token`	`PODIO_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`url`	`PODIO_URL`	URL `url`	no	API Base URL

Call Podio Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call podio.podio_list_spaces '{
  "org_id": 1
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:podio podio_list_spaces '{
  "org_id": 1
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs podio --json
kosmo integrations:docs podio.podio_list_spaces --json
kosmo integrations:schema podio.podio_list_spaces --json
kosmo integrations:search "Podio" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Podio.

`podio.podio_list_spaces`

Read 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.

Parameters: org_id

Generic CLI call

kosmo integrations:call podio.podio_list_spaces '{"org_id":1}' --json

Provider shortcut

kosmo integrations:podio podio_list_spaces '{"org_id":1}' --json

`podio.podio_get_space`

Read 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.

Parameters: space_id

Generic CLI call

kosmo integrations:call podio.podio_get_space '{"space_id":1}' --json

Provider shortcut

kosmo integrations:podio podio_get_space '{"space_id":1}' --json

`podio.podio_list_apps`

Read 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.

Parameters: space_id

Generic CLI call

kosmo integrations:call podio.podio_list_apps '{"space_id":1}' --json

Provider shortcut

kosmo integrations:podio podio_list_apps '{"space_id":1}' --json

`podio.podio_get_app`

Read 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.

Parameters: app_id

Generic CLI call

kosmo integrations:call podio.podio_get_app '{"app_id":1}' --json

Provider shortcut

kosmo integrations:podio podio_get_app '{"app_id":1}' --json

`podio.podio_list_items`

Read 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.

Parameters: app_id, limit, offset, sort_by, sort_desc, filters

Generic CLI call

kosmo integrations:call podio.podio_list_items '{"app_id":1,"limit":1,"offset":1,"sort_by":"example_sort_by","sort_desc":true,"filters":"example_filters"}' --json

Provider shortcut

kosmo integrations:podio podio_list_items '{"app_id":1,"limit":1,"offset":1,"sort_by":"example_sort_by","sort_desc":true,"filters":"example_filters"}' --json

`podio.podio_get_item`

Read 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.

Parameters: item_id

Generic CLI call

kosmo integrations:call podio.podio_get_item '{"item_id":1}' --json

Provider shortcut

kosmo integrations:podio podio_get_item '{"item_id":1}' --json

`podio.podio_get_current_user`

Read read

Get the status of the currently authenticated Podio user, including profile information, active organization memberships, and account details.

Parameters: none

Generic CLI call

kosmo integrations:call podio.podio_get_current_user '{}' --json

Provider shortcut

kosmo integrations:podio podio_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`podio.podio_list_spaces`

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.

Operation: Read read
Schema command: kosmo integrations:schema podio.podio_list_spaces --json

Parameter	Type	Required	Description
`org_id`	integer	yes	The Podio organization ID to list spaces for.

`podio.podio_get_space`

Get detailed information about a specific Podio workspace, including its name, description, URL, and settings. Use the space ID obtained from podio_list_spaces.

Operation: Read read
Schema command: kosmo integrations:schema podio.podio_get_space --json

Parameter	Type	Required	Description
`space_id`	integer	yes	The Podio space (workspace) ID.

`podio.podio_list_apps`

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.

Operation: Read read
Schema command: kosmo integrations:schema podio.podio_list_apps --json

Parameter	Type	Required	Description
`space_id`	integer	yes	The Podio space (workspace) ID to list apps for.

`podio.podio_get_app`

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.

Operation: Read read
Schema command: kosmo integrations:schema podio.podio_get_app --json

Parameter	Type	Required	Description
`app_id`	integer	yes	The Podio app ID.

`podio.podio_list_items`

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.

Operation: Read read
Schema command: kosmo integrations:schema podio.podio_list_items --json

Parameter	Type	Required	Description
`app_id`	integer	yes	The Podio app ID to list items from.
`limit`	integer	no	Maximum number of items to return (default: 20, max: 500).
`offset`	integer	no	Offset for pagination (default: 0).
`sort_by`	string	no	The field to sort by. Use "created_on" or "last_event_on" for built-in sorting, or a field external ID.
`sort_desc`	boolean	no	Sort in descending order (default: true).
`filters`	string	no	JSON-encoded filter object. Keys are field external IDs, values are the filter criteria. Example: '{"title":"My Item"}'

`podio.podio_get_item`

Get detailed information about a specific Podio item, including all field values, references, and metadata. Use the item ID obtained from podio_list_items.

Operation: Read read
Schema command: kosmo integrations:schema podio.podio_get_item --json

Parameter	Type	Required	Description
`item_id`	integer	yes	The Podio item ID.

`podio.podio_get_current_user`

Get the status of the currently authenticated Podio user, including profile information, active organization memberships, and account details.

Operation: Read read
Schema command: kosmo integrations:schema podio.podio_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.