Can I use Tableau as a CLI?

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

Can I expose Tableau through MCP?

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

Where are Tableau credentials stored?

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

Can I deny write access for Tableau MCP tools?

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

analytics

Tableau CLI for AI Agents

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

Tableau CLI Setup

Tableau can be configured headlessly with `kosmokrator integrations:configure tableau`.

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 tableau --set access_token="$TABLEAU_ACCESS_TOKEN" --set site_id="$TABLEAU_SITE_ID" --enable --read allow --write ask --json
kosmokrator integrations:doctor tableau --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`	`TABLEAU_ACCESS_TOKEN`	Secret `secret`	yes	Access Token
`site_id`	`TABLEAU_SITE_ID`	Text `string`	yes	Site ID
`base_url`	`TABLEAU_BASE_URL`	URL `url`	no	Server URL

Command Patterns

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

Generic CLI call

kosmo integrations:call tableau.tableau_list_workbooks '{"page_size":1,"page_number":1}' --json

Provider shortcut

kosmo integrations:tableau tableau_list_workbooks '{"page_size":1,"page_number":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 tableau --json
kosmo integrations:docs tableau.tableau_list_workbooks --json
kosmo integrations:schema tableau.tableau_list_workbooks --json
kosmo integrations:search "Tableau" --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.

`tableau.tableau_list_workbooks`

List workbooks available on the Tableau site. Returns workbook names, IDs, project assignments, and owners. Use the workbook IDs with tableau_get_workbook for full details.

Read read

Parameters: page_size, page_number

Generic call

kosmo integrations:call tableau.tableau_list_workbooks '{"page_size":1,"page_number":1}' --json

Shortcut

kosmo integrations:tableau tableau_list_workbooks '{"page_size":1,"page_number":1}' --json

`tableau.tableau_get_workbook`

Get detailed information about a specific Tableau workbook, including its views, connections, and permissions. Requires the workbook LUID.

Read read

Parameters: workbook_id

Generic call

kosmo integrations:call tableau.tableau_get_workbook '{"workbook_id":"example_workbook_id"}' --json

Shortcut

kosmo integrations:tableau tableau_get_workbook '{"workbook_id":"example_workbook_id"}' --json

`tableau.tableau_list_views`

List views (dashboards and sheets) available on the Tableau site. Returns view names, IDs, and associated workbooks. Use view IDs with tableau_get_view for full details.

Read read

Parameters: page_size, page_number

Generic call

kosmo integrations:call tableau.tableau_list_views '{"page_size":1,"page_number":1}' --json

Shortcut

kosmo integrations:tableau tableau_list_views '{"page_size":1,"page_number":1}' --json

`tableau.tableau_get_view`

Get detailed information about a specific Tableau view (dashboard or sheet), including its workbook, owner, and usage stats. Requires the view LUID.

Read read

Parameters: view_id

Generic call

kosmo integrations:call tableau.tableau_get_view '{"view_id":"example_view_id"}' --json

Shortcut

kosmo integrations:tableau tableau_get_view '{"view_id":"example_view_id"}' --json

`tableau.tableau_list_projects`

List projects on the Tableau site. Projects organize workbooks and data sources. Returns project names, IDs, descriptions, and parent project info.

Read read

Parameters: page_size, page_number

Generic call

kosmo integrations:call tableau.tableau_list_projects '{"page_size":1,"page_number":1}' --json

Shortcut

kosmo integrations:tableau tableau_list_projects '{"page_size":1,"page_number":1}' --json

`tableau.tableau_get_current_user`

Get information about the currently authenticated Tableau user, including name, email, site role, and auth settings.

Read read

Parameters: none

Generic call

kosmo integrations:call tableau.tableau_get_current_user '{}' --json

Shortcut

kosmo integrations:tableau tableau_get_current_user '{}' --json

Function Schemas

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

tableau.tableau_list_workbooks 2 parameters

Schema command

kosmo integrations:schema tableau.tableau_list_workbooks --json

Parameter	Type	Required	Description
`page_size`	integer	no	Number of workbooks per page (default: 100, max: 1000).
`page_number`	integer	no	Page number for pagination (1-based, default: 1).

tableau.tableau_get_workbook 1 parameters

Schema command

kosmo integrations:schema tableau.tableau_get_workbook --json

Parameter	Type	Required	Description
`workbook_id`	string	yes	The workbook LUID (unique identifier). Obtain from tableau_list_workbooks.

tableau.tableau_list_views 2 parameters

Schema command

kosmo integrations:schema tableau.tableau_list_views --json

Parameter	Type	Required	Description
`page_size`	integer	no	Number of views per page (default: 100, max: 1000).
`page_number`	integer	no	Page number for pagination (1-based, default: 1).

tableau.tableau_get_view 1 parameters

Schema command

kosmo integrations:schema tableau.tableau_get_view --json

Parameter	Type	Required	Description
`view_id`	string	yes	The view LUID (unique identifier). Obtain from tableau_list_views.

tableau.tableau_list_projects 2 parameters

Schema command

kosmo integrations:schema tableau.tableau_list_projects --json

Parameter	Type	Required	Description
`page_size`	integer	no	Number of projects per page (default: 100, max: 1000).
`page_number`	integer	no	Page number for pagination (1-based, default: 1).

tableau.tableau_get_current_user 0 parameters

Schema command

kosmo integrations:schema tableau.tableau_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.