KosmoKrator

analytics

Klipfolio CLI for AI Agents

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

7 functions 7 read 0 write Bearer token auth

Klipfolio CLI Setup

Klipfolio can be configured headlessly with `kosmokrator integrations:configure klipfolio`.

# 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 klipfolio --set access_token="$KLIPFOLIO_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor klipfolio --json
kosmokrator integrations:status --json

Credentials

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

KeyEnv varTypeRequiredLabel
access_token KLIPFOLIO_ACCESS_TOKEN Secret secret yes Access Token
url KLIPFOLIO_URL URL url no Klipfolio URL

Call Klipfolio Headlessly

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

kosmo integrations:call klipfolio.klipfolio_list_dashboards '{
  "limit": 1,
  "page": 1
}' --json

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

kosmo integrations:klipfolio klipfolio_list_dashboards '{
  "limit": 1,
  "page": 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 klipfolio --json
kosmo integrations:docs klipfolio.klipfolio_list_dashboards --json
kosmo integrations:schema klipfolio.klipfolio_list_dashboards --json
kosmo integrations:search "Klipfolio" --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 Klipfolio.

klipfolio.klipfolio_list_dashboards

Read read

List all dashboards accessible to the authenticated user in Klipfolio. Returns dashboard IDs, names, and metadata.

Parameters
limit, page

Generic CLI call

kosmo integrations:call klipfolio.klipfolio_list_dashboards '{"limit":1,"page":1}' --json

Provider shortcut

kosmo integrations:klipfolio klipfolio_list_dashboards '{"limit":1,"page":1}' --json

klipfolio.klipfolio_get_dashboard

Read read

Get details for a specific Klipfolio dashboard by ID, including its layout, Klips, and sharing settings.

Parameters
id

Generic CLI call

kosmo integrations:call klipfolio.klipfolio_get_dashboard '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:klipfolio klipfolio_get_dashboard '{"id":"example_id"}' --json

klipfolio.klipfolio_list_metrics

Read read

List all metrics accessible to the authenticated user in Klipfolio. Returns metric IDs, names, and associated data sources.

Parameters
limit, page

Generic CLI call

kosmo integrations:call klipfolio.klipfolio_list_metrics '{"limit":1,"page":1}' --json

Provider shortcut

kosmo integrations:klipfolio klipfolio_list_metrics '{"limit":1,"page":1}' --json

klipfolio.klipfolio_get_metric

Read read

Get details for a specific Klipfolio metric by ID, including its formula, data bindings, and formatting.

Parameters
id

Generic CLI call

kosmo integrations:call klipfolio.klipfolio_get_metric '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:klipfolio klipfolio_get_metric '{"id":"example_id"}' --json

klipfolio.klipfolio_list_datasources

Read read

List all data sources accessible to the authenticated user in Klipfolio. Returns data source IDs, names, and connector types.

Parameters
limit, page

Generic CLI call

kosmo integrations:call klipfolio.klipfolio_list_datasources '{"limit":1,"page":1}' --json

Provider shortcut

kosmo integrations:klipfolio klipfolio_list_datasources '{"limit":1,"page":1}' --json

klipfolio.klipfolio_get_datasource

Read read

Get details for a specific Klipfolio data source by ID, including its connector type, refresh settings, and configuration.

Parameters
id

Generic CLI call

kosmo integrations:call klipfolio.klipfolio_get_datasource '{"id":"example_id"}' --json

Provider shortcut

kosmo integrations:klipfolio klipfolio_get_datasource '{"id":"example_id"}' --json

klipfolio.klipfolio_get_current_user

Read read

Get the authenticated Klipfolio user's profile information, including name, email, and role.

Parameters
none

Generic CLI call

kosmo integrations:call klipfolio.klipfolio_get_current_user '{}' --json

Provider shortcut

kosmo integrations:klipfolio klipfolio_get_current_user '{}' --json

Function Schemas

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

klipfolio.klipfolio_list_dashboards

List all dashboards accessible to the authenticated user in Klipfolio. Returns dashboard IDs, names, and metadata.

Operation
Read read
Schema command
kosmo integrations:schema klipfolio.klipfolio_list_dashboards --json
ParameterTypeRequiredDescription
limit integer no Maximum number of dashboards to return per page (default: 25).
page integer no Page number for pagination, 1-based (default: 1).

klipfolio.klipfolio_get_dashboard

Get details for a specific Klipfolio dashboard by ID, including its layout, Klips, and sharing settings.

Operation
Read read
Schema command
kosmo integrations:schema klipfolio.klipfolio_get_dashboard --json
ParameterTypeRequiredDescription
id string yes The unique dashboard identifier.

klipfolio.klipfolio_list_metrics

List all metrics accessible to the authenticated user in Klipfolio. Returns metric IDs, names, and associated data sources.

Operation
Read read
Schema command
kosmo integrations:schema klipfolio.klipfolio_list_metrics --json
ParameterTypeRequiredDescription
limit integer no Maximum number of metrics to return per page (default: 25).
page integer no Page number for pagination, 1-based (default: 1).

klipfolio.klipfolio_get_metric

Get details for a specific Klipfolio metric by ID, including its formula, data bindings, and formatting.

Operation
Read read
Schema command
kosmo integrations:schema klipfolio.klipfolio_get_metric --json
ParameterTypeRequiredDescription
id string yes The unique metric identifier.

klipfolio.klipfolio_list_datasources

List all data sources accessible to the authenticated user in Klipfolio. Returns data source IDs, names, and connector types.

Operation
Read read
Schema command
kosmo integrations:schema klipfolio.klipfolio_list_datasources --json
ParameterTypeRequiredDescription
limit integer no Maximum number of data sources to return per page (default: 25).
page integer no Page number for pagination, 1-based (default: 1).

klipfolio.klipfolio_get_datasource

Get details for a specific Klipfolio data source by ID, including its connector type, refresh settings, and configuration.

Operation
Read read
Schema command
kosmo integrations:schema klipfolio.klipfolio_get_datasource --json
ParameterTypeRequiredDescription
id string yes The unique data source identifier.

klipfolio.klipfolio_get_current_user

Get the authenticated Klipfolio user's profile information, including name, email, and role.

Operation
Read read
Schema command
kosmo integrations:schema klipfolio.klipfolio_get_current_user --json
ParameterTypeRequiredDescription
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.