Can I use Klipfolio as a CLI?

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

Can I expose Klipfolio through MCP?

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

Where are Klipfolio credentials stored?

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

Can I deny write access for Klipfolio MCP tools?

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

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.

Klipfolio CLI Setup

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

Install, configure, and verify

# 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 reuse the same stored profile from scripts, coding CLIs, Lua, and MCP.

Key	Env var	Type	Required	Label
`access_token`	`KLIPFOLIO_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`url`	`KLIPFOLIO_URL`	URL `url`	no	Klipfolio URL

Command Patterns

The generic command is stable across every integration. The provider shortcut is shorter for humans.

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

Discovery

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

Discovery commands

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

Automation Contexts

The same configured command surface works in these environments. The command does not change unless the host wrapper, credentials, or permissions change.

CI Run integration calls from CI jobs with JSON output, explicit credentials, and predictable exit status. Cron Jobs Schedule repeatable integration workflows from cron while keeping credentials in KosmoKrator config. Shell Scripts Call integration functions from shell scripts with stable JSON input and output. Headless Automation Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers. Coding Agents Let coding agents discover schemas and execute integration functions through CLI commands or MCP.

CLI Functions

Every function below can be called headlessly. Commands are highlighted, copyable, and scroll horizontally when payloads are long.

`klipfolio.klipfolio_list_dashboards`

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

Read read

Parameters: limit, page

Generic call

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

Shortcut

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

`klipfolio.klipfolio_get_dashboard`

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

Read read

Parameters: id

Generic call

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

Shortcut

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

`klipfolio.klipfolio_list_metrics`

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

Read read

Parameters: limit, page

Generic call

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

Shortcut

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

`klipfolio.klipfolio_get_metric`

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

Read read

Parameters: id

Generic call

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

Shortcut

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

`klipfolio.klipfolio_list_datasources`

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

Read read

Parameters: limit, page

Generic call

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

Shortcut

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

`klipfolio.klipfolio_get_datasource`

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

Read read

Parameters: id

Generic call

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

Shortcut

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

`klipfolio.klipfolio_get_current_user`

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

Read read

Parameters: none

Generic call

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

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 2 parameters

Schema command

kosmo integrations:schema klipfolio.klipfolio_list_dashboards --json

Parameter	Type	Required	Description
`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 1 parameters

Schema command

kosmo integrations:schema klipfolio.klipfolio_get_dashboard --json

Parameter	Type	Required	Description
`id`	string	yes	The unique dashboard identifier.

klipfolio.klipfolio_list_metrics 2 parameters

Schema command

kosmo integrations:schema klipfolio.klipfolio_list_metrics --json

Parameter	Type	Required	Description
`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 1 parameters

Schema command

kosmo integrations:schema klipfolio.klipfolio_get_metric --json

Parameter	Type	Required	Description
`id`	string	yes	The unique metric identifier.

klipfolio.klipfolio_list_datasources 2 parameters

Schema command

kosmo integrations:schema klipfolio.klipfolio_list_datasources --json

Parameter	Type	Required	Description
`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 1 parameters

Schema command

kosmo integrations:schema klipfolio.klipfolio_get_datasource --json

Parameter	Type	Required	Description
`id`	string	yes	The unique data source identifier.

klipfolio.klipfolio_get_current_user 0 parameters

Schema command

kosmo integrations:schema klipfolio.klipfolio_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.