# Tableau MCP > Tableau's official MCP Server. Helping Agents see and understand data. This file is the map of every published page. For contract full text (arguments, API routes, notes — under 1 MB) fetch [llms-full.txt](https://tableau.github.io/tableau-mcp/llms/llms-full.txt). Examples stay on each HTML page. ## Introduction - [Introduction](https://tableau.github.io/tableau-mcp/docs/intro): Tableau's official MCP Server. ## Getting Started - [Getting Started](https://tableau.github.io/tableau-mcp/docs/getting-started): This guide walks you through getting started with Tableau MCP. ## Release notes - [Release notes](https://tableau.github.io/tableau-mcp/docs/release-notes): What's changed in the Tableau MCP tools. ## Hosted Tableau MCP - [Hosted Tableau MCP](https://tableau.github.io/tableau-mcp/docs/hosted-tableau-mcp): Tableau MCP is available as a managed service on every Tableau Cloud pod, accessible at a single URL: **https://mcp.tableau.com**. - [Architecture](https://tableau.github.io/tableau-mcp/docs/hosted-tableau-mcp/architecture): AI agents (such as Claude, ChatGPT, Slackbot or other AI clients) connect to the hosted Tableau MCP service through the Tableau routing layer (CloudFront edge location+compute) which routes the request to a corresponding Tableau Cloud pod. - [Popular Client Integrations](https://tableau.github.io/tableau-mcp/docs/hosted-tableau-mcp/client-integrations): This guide walks you through everything you need to use Tableau MCP with popular third-party agents. ## Web Tools > Reference documentation for each Tableau service-facing tool exposed by Tableau MCP over the web (HTTP/stdio) transports. These tools may depend on the calls to Tableau REST API, the Tableau VizQL Data Service (VDS API), or the Metadata API. ### Admin Insights > Admin-only tools that query Tableau Cloud Admin Insights datasources via the VizQL Data Service. Gated by the `ADMIN_TOOLS_ENABLED` environment variable and a request-time site-role check. - [Query Admin Insights](https://tableau.github.io/tableau-mcp/docs/web-tools/admin-insights/query-admin-insights): Queries the Tableau Cloud Admin Insights datasources on the current site and the deterministic stale-content report through a single entry point. ### Content Exploration > Tools for exploring content in a Tableau Site. - [Search Content](https://tableau.github.io/tableau-mcp/docs/web-tools/content-exploration/search-content): Searches across all supported content types in a Tableau Site for objects relevant to the search query, matching against the provided search terms and filters. ### Content Management > Admin-only tools for managing content lifecycle on Tableau Cloud — deletion, archival, and recycle-bin operations. Gated by the `ADMIN_TOOLS_ENABLED` environment variable and a request-time site-role check. - [Delete Tableau Content](https://tableau.github.io/tableau-mcp/docs/web-tools/content/delete-content): Permanently deletes a workbook, published data source, or extract refresh task. ### Data Apps > Tools for scaffolding workbook data apps. - [Scaffold a Desktop data app](https://tableau.github.io/tableau-mcp/docs/web-tools/data-apps/scaffold-data-app): Prepares a data app package and worksheetFile for an open sheet. ### Data Q&A > Tools for querying published data sources. - [List Datasources](https://tableau.github.io/tableau-mcp/docs/web-tools/data-qna/list-datasources): Retrieves a list of published data sources from a Tableau site, with optional filtering via field:operator:value expressions (e.g. - [Get Datasource Metadata](https://tableau.github.io/tableau-mcp/docs/web-tools/data-qna/get-datasource-metadata): Retrieves metadata for a specified data source, taking the basic, high-level metadata from Tableau's VizQL Data Service and enriching it with additional context from Tableau's Metadata API. - [Query Datasource](https://tableau.github.io/tableau-mcp/docs/web-tools/data-qna/query-datasource): Executes VizQL queries against a published Tableau data source to answer business questions from your data. - [Publish Datasource](https://tableau.github.io/tableau-mcp/docs/web-tools/data-qna/publish-datasource): Publishes a TDS or TDSX data source from a staged upload id, or from a local file path when the MCP server runs over stdio, to the specified Tableau project. - [Request Datasource Upload](https://tableau.github.io/tableau-mcp/docs/web-tools/data-qna/request-datasource-upload): Creates a short-lived staged upload URL for a Tableau TDS or TDSX data source. ### Flows > Tools for retrieving information about Tableau Prep flows. - [List Flows](https://tableau.github.io/tableau-mcp/docs/web-tools/flows/list-flows): Retrieves a list of Tableau Prep flows on a site, including each flow's metadata such as name, description, owner, project, tags, and timestamps. - [Get Flow](https://tableau.github.io/tableau-mcp/docs/web-tools/flows/get-flow): Retrieves detailed information about a specific Tableau Prep flow, including its output steps and optionally its input data connections and recent flow runs. - [Cancel Flow Run](https://tableau.github.io/tableau-mcp/docs/web-tools/flows/cancel-flow-run): Requests cancellation of a **queued or in-progress Tableau Prep flow run**, by flow *run* id (not flow id). - [Describe Flow](https://tableau.github.io/tableau-mcp/docs/web-tools/flows/describe-flow): Explains what a Tableau Prep flow actually *does* by reading and summarizing the flow's underlying document (the design of the flow itself, not just its catalog metadata). - [Get Flow Task](https://tableau.github.io/tableau-mcp/docs/web-tools/flows/get-flow-task): Retrieves a single scheduled flow run task (the **schedule** for a Tableau Prep flow) by its task id. - [List Flow Runs](https://tableau.github.io/tableau-mcp/docs/web-tools/flows/list-flow-runs): Retrieves the run history (executions) of Tableau Prep flows on a site. - [List Flow Tasks](https://tableau.github.io/tableau-mcp/docs/web-tools/flows/list-flow-tasks): Retrieves the scheduled flow run tasks on a Tableau site. - [Run Flow](https://tableau.github.io/tableau-mcp/docs/web-tools/flows/run-flow): Runs a Tableau Prep flow **on demand** ("Run Now") through a required two-phase confirmation. - [Run Flow Task](https://tableau.github.io/tableau-mcp/docs/web-tools/flows/run-flow-task): Runs an **existing scheduled flow run task** now ("Run Now" on a schedule), by task id. ### Jobs > Tools for monitoring background jobs such as extract refreshes, subscriptions, and flow runs. - [List Jobs](https://tableau.github.io/tableau-mcp/docs/web-tools/jobs/list-jobs): Retrieves a list of background jobs for the Tableau site. ### Projects > Tools for retrieving information about projects. - [List Projects](https://tableau.github.io/tableau-mcp/docs/web-tools/projects/list-projects): Retrieves a list of projects on a Tableau site, including metadata such as name, description, parent project, content permissions, owner, and timestamps. ### Pulse > Tools for retrieving information about Pulse metrics. - [List All Pulse Metric Definitions](https://tableau.github.io/tableau-mcp/docs/web-tools/pulse/list-all-pulse-metric-definitions): Retrieves a list of all published Tableau Pulse metric definitions on the current site. - [List Pulse Metric Definitions from Metric Definition IDs](https://tableau.github.io/tableau-mcp/docs/web-tools/pulse/list-pulse-metric-definitions-from-definition-ids): Retrieves a list of specific Pulse metric definitions from a list of metric definition IDs. - [List Pulse Metrics from Metric Definition ID](https://tableau.github.io/tableau-mcp/docs/web-tools/pulse/list-pulse-metrics-from-metric-definition-id): Retrieves a list of published Pulse metrics for a single Pulse metric definition. - [List Pulse Metrics from Metric IDs](https://tableau.github.io/tableau-mcp/docs/web-tools/pulse/list-pulse-metrics-from-metric-ids): Retrieves a list of published Pulse metrics for a list of metric IDs on the current site. - [List Pulse Metric Subscriptions for Current User](https://tableau.github.io/tableau-mcp/docs/web-tools/pulse/list-pulse-metric-subscriptions): Retrieves a list of published Pulse Metric Subscriptions for the current user. - [Generate Pulse Metric Value Insight Bundle](https://tableau.github.io/tableau-mcp/docs/web-tools/pulse/generate-pulse-metric-value-insight-bundle): Generates an insight bundle for the current aggregated value of a Pulse metric. - [Generate Pulse Insight Brief](https://tableau.github.io/tableau-mcp/docs/web-tools/pulse/generate-pulse-insight-brief): Generates AI-powered conversational insights for Pulse metrics based on natural language questions. - [Generate Insight Cards](https://tableau.github.io/tableau-mcp/docs/web-tools/pulse/generate-insight-cards): Generates a set of deterministic, governed **insight cards** for a published data source. ### Tableau Knowledge > Tools for reading and updating Tableau Knowledge. - [Inspect Knowledge Context](https://tableau.github.io/tableau-mcp/docs/web-tools/knowledge/inspect-knowledge-context): Review what is recorded in Tableau Knowledge without changing it: which graphs exist, every stored business rule, definition or note (for the whole graph or for one node), and the graph's health and improvement suggestions. - [Manage Knowledge Context](https://tableau.github.io/tableau-mcp/docs/web-tools/knowledge/manage-knowledge-context): Record, revise, or retire the organization's governed business definitions, rules, and notes in Tableau Knowledge ("add a rule", "update the definition of ...", "remove that note"). - [Query Knowledge Context](https://tableau.github.io/tableau-mcp/docs/web-tools/knowledge/query-knowledge-context): Consult Tableau Knowledge, the organization's governed record of what its data means, before answering questions about business definitions, metric and reporting rules, which field or data source to trust, where data comes from, or what a change would break. ### Tasks > Tools for managing and monitoring extract refresh tasks. - [List Extract Refresh Tasks](https://tableau.github.io/tableau-mcp/docs/web-tools/tasks/list-extract-refresh-tasks): Retrieves a list of extract refresh tasks for the Tableau site. - [Update Cloud Extract Refresh Task](https://tableau.github.io/tableau-mcp/docs/web-tools/tasks/update-cloud-extract-refresh-task): Updates the schedule of an extract refresh task on Tableau Cloud. ### Token Management > Tools for managing OAuth token and consent state for the current MCP session. - [Reset Consent](https://tableau.github.io/tableau-mcp/docs/web-tools/token-management/reset-consent): Resets saved OAuth consent for the current user on the Tableau authorization server. - [Revoke Access Token](https://tableau.github.io/tableau-mcp/docs/web-tools/token-management/revoke-access-token): Revokes the access token used to authenticate the current MCP session. ### Users > Tools for retrieving information about users on the Tableau site. - [List Users](https://tableau.github.io/tableau-mcp/docs/web-tools/users/list-users): Retrieves a list of users on the Tableau site. - [Update User](https://tableau.github.io/tableau-mcp/docs/web-tools/users/update-user): Updates the site role of a user on the Tableau site. ### Views > Tools for retrieving information about views within workbooks. - [List Views](https://tableau.github.io/tableau-mcp/docs/web-tools/views/list-views): Retrieves a list of views on a Tableau site, including metadata such as each view's name, owner, and the workbook it belongs to. - [Get View Image](https://tableau.github.io/tableau-mcp/docs/web-tools/views/get-view-image): Retrieves an image of the specified view in a Tableau workbook. - [Get View Data](https://tableau.github.io/tableau-mcp/docs/web-tools/views/get-view-data): Retrieves data in comma separated value (CSV) format for the specified view in a Tableau workbook, including the user's filters. - [List Custom Views](https://tableau.github.io/tableau-mcp/docs/web-tools/views/list-custom-views): Retrieves a list of custom views for a specified Tableau workbook, including their metadata such as name, owner, and the view they are found in. - [Get Custom View Data](https://tableau.github.io/tableau-mcp/docs/web-tools/views/get-custom-view-data): Retrieves comma-separated value (CSV) data for a Tableau custom view — a saved or personalized state of a published sheet, including the user's filters. - [Get Custom View Image](https://tableau.github.io/tableau-mcp/docs/web-tools/views/get-custom-view-image): Retrieves an image for a **custom view** (a saved or personalized state of a published sheet, including the user's filters). - [Get View](https://tableau.github.io/tableau-mcp/docs/web-tools/views/get-view): Retrieves information about the specified view, including its upstream datasources, workbook information, project details, owner, tags, and usage statistics. - [Render Interactive Viz](https://tableau.github.io/tableau-mcp/docs/web-tools/views/render-interactive-viz): Renders a workbook or view (identified by luid, objectType "workbook" or "view") as a live, interactive Tableau embed the user can explore — filter, drill down, hover, and change selections in place. ### Workbooks > Tools for retrieving information about workbooks. - [List Workbooks](https://tableau.github.io/tableau-mcp/docs/web-tools/workbooks/list-workbooks): Retrieves a list of workbooks on a Tableau site, including their metadata such as name, description, and information about the views contained in each workbook. - [Get Workbook](https://tableau.github.io/tableau-mcp/docs/web-tools/workbooks/get-workbook): Retrieves information about a single workbook, including the views it contains and their usage statistics. - [Download Workbook](https://tableau.github.io/tableau-mcp/docs/web-tools/workbooks/download-workbook): Downloads workbook content as a TWB (application/xml) or TWBX (application/octet-stream) file. - [Move Workbook](https://tableau.github.io/tableau-mcp/docs/web-tools/workbooks/move-workbook): Moves a workbook into a different project. - [Request Workbook Upload](https://tableau.github.io/tableau-mcp/docs/web-tools/workbooks/request-workbook-upload): Creates a short-lived staged upload URL for a Tableau TWB or TWBX workbook. ## Desktop Tools > Reference documentation for tools exposed by the Tableau MCP desktop variant, which drive a local Tableau Studio instance via Tableau's External Client API. ### Binder > Tools for listing, proposing, validating, and binding reusable authoring templates. - [Match Template](https://tableau.github.io/tableau-mcp/docs/desktop-tools/binder/bind-template): Builds a chart from a plain-language ask by matching it to a reusable authoring template. - [List Bundled Chart Templates](https://tableau.github.io/tableau-mcp/docs/desktop-tools/binder/list-templates): Searches the worksheet chart templates available to the MCP server on this machine — the set that ships in-package, plus any additional templates and saved bookmarks found in the local Tableau Studio repository — and returns a page of compact summaries. ### Cache > Tools for reading, writing, and validating cached workbook and worksheet XML. - [Read Cached Workbook Draft](https://tableau.github.io/tableau-mcp/docs/desktop-tools/cache/read-cached-xml): Reads a cached workbook or worksheet XML working copy from the MCP server's local cache directory and returns its contents. - [Validate Workbook Draft](https://tableau.github.io/tableau-mcp/docs/desktop-tools/cache/validate-workbook-xml): Checks workbook XML for problems before you apply it to the open workbook with apply-workbook, so invalid content never reaches Tableau Studio. - [Validate Worksheet Draft](https://tableau.github.io/tableau-mcp/docs/desktop-tools/cache/validate-worksheet-xml): Checks that a worksheet's content is well-formed XML before you apply it. - [Save Cached Workbook Draft](https://tableau.github.io/tableau-mcp/docs/desktop-tools/cache/write-cached-xml): Saves workbook or worksheet XML to a cache file on the server's local machine, so it can later be applied to the workbook open in Tableau Studio with an apply-* tool. ### Dashboards > Tools for building, applying, and inspecting dashboards in the open workbook. - [Add Dashboard](https://tableau.github.io/tableau-mcp/docs/desktop-tools/dashboard/add-dashboard): Add a blank dashboard to the open workbook. - [Apply Dashboard Changes](https://tableau.github.io/tableau-mcp/docs/desktop-tools/dashboard/apply-dashboard): Applies a modified dashboard layout to the dashboard of that name in the workbook currently open in Tableau Studio, replacing it with the dashboard XML you supply. - [Apply Worksheets and Compose Dashboard](https://tableau.github.io/tableau-mcp/docs/desktop-tools/dashboard/run-dashboard-batch): Applies a queue of prepared worksheets to the workbook open in Tableau Studio and then composes them into a dashboard, in one ordered pass (apply, then compose). - [Export Dashboard Image](https://tableau.github.io/tableau-mcp/docs/desktop-tools/dashboard/export-dashboard-image): Renders one dashboard from the workbook open in Tableau Studio as an image. - [Format Dashboard Zones](https://tableau.github.io/tableau-mcp/docs/desktop-tools/dashboard/format-dashboard-zones): Sets rounded corners on the zones of a dashboard in the workbook open in Tableau Studio. ### Data Sources > Tools for authoring calculations, parameters, sets, and actions, and for inventorying datasources and workbooks. - [Get Worksheet Underlying Data](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/get-worksheet-underlying-data): Reads row-level underlying data for one of a worksheet's logical tables in the workbook open in the connected Tableau Studio instance — the table's rows, not the aggregated summary of the view. - [Author Action](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/author-action): Authors an action in the workbook currently open in Tableau Studio. - [Author Calc](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/author-calc): Authors a new calculated field — a caption plus a Tableau formula — into a datasource of the workbook open in Tableau Studio. - [Author Parameter](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/author-parameter): Adds a new parameter to the workbook open in the local Tableau Studio instance. - [Author Set](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/author-set): Authors a set on a dimension in the workbook open in Tableau Studio and applies it to the live workbook. - [Get App Info](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/get-app-info): Reports application information about the Tableau Studio instance that is currently running, including live UI state. - [Get Summary Data](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/get-summary-data): Reads the aggregated summary rows on a populated worksheet in the workbook open in the connected Tableau Studio instance — only the fields on the view, not its chart specification. - [Get Datasources](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/get-datasources): List every datasource in the open workbook, or read one of them. - [List Worksheet Logical Tables](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/list-worksheet-logical-tables): Lists the logical tables of one worksheet in the workbook open in the connected Tableau Studio instance, returning each table's id and caption — the identifiers you pass when reading that worksheet's row-level underlying data with get-worksheet-underlying-data. - [Apply Datasource Changes](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/apply-datasource): Replaces an existing datasource definition in the workbook currently open in Tableau Studio with a document previously retrieved from that workbook. - [Get Datasource Underlying Data](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/get-datasource-underlying-data): Read raw row-level data for one of a datasource's logical tables (see list-datasource-logical-tables), independent of any worksheet. - [List Datasource Logical Tables](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/list-datasource-logical-tables): List a datasource's logical tables (id + caption), the input to get-datasource-underlying-data. - [List Saved Data Sources](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/list-saved-datasources): Lists Tableau Studio's Saved Data Sources (My Tableau Repository, including bundled samples like World Indicators and Sample - Superstore). - [Set Data Source Page Active](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/set-data-source-page-active): Switch Tableau Studio to the Data Source page or back to a sheet, and return the page state read back. - [Validate Calculated Field](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/validate-calculated-field): Check a new or edited calculated field against a datasource without changing the workbook. - [Refresh Datasource](https://tableau.github.io/tableau-mcp/docs/desktop-tools/data-source/refresh-datasource): Refresh a datasource in the open workbook. ### Dialogs > Tools for listing modal dialogs in Tableau Studio and invoking a specific dialog action. - [Get Active Dialogs](https://tableau.github.io/tableau-mcp/docs/desktop-tools/dialogs/get-active-dialogs): Lists the current actionable dialogs in the connected Tableau Studio instance, including each dialog's exact identity, visible message and diagnostic text, and invokable actions. - [Invoke Dialog Action](https://tableau.github.io/tableau-mcp/docs/desktop-tools/dialogs/invoke-dialog-action): Invokes one visible, enabled action on one current Tableau Studio dialog. ### Expertise > Tools for searching and reading the authoring guidance library. - [Search Expertise](https://tableau.github.io/tableau-mcp/docs/desktop-tools/expertise/search-expertise): Searches the authoring-guidance library by concept — chart choice, calculation patterns, workbook structure, and dashboard layout — and returns the closest modules as JSON. - [Read an Authoring Guide](https://tableau.github.io/tableau-mcp/docs/desktop-tools/expertise/read-expertise-resource): Reads one module from the authoring-guidance library, or a single section of it, and returns the markdown. ### External API > Passthrough tools that expose the Tableau Studio external API surface (site, dashboard, worksheet, and health info). - [Get Workbook Capabilities](https://tableau.github.io/tableau-mcp/docs/desktop-tools/external-api/get-capabilities): Return the External Client API capability matrix: for each operation id, whether it requires a Tableau Server connection (requiresServer). - [Get Workbook Diagnostics](https://tableau.github.io/tableau-mcp/docs/desktop-tools/external-api/get-diagnostics): Inspect the existing workbook before editing. - [Get Operations](https://tableau.github.io/tableau-mcp/docs/desktop-tools/external-api/get-operations): List in-flight and recent Tableau Studio operations, or read one of them. ### Fields > Tools for listing, adding, removing, and resolving fields on a worksheet. - [Add Field](https://tableau.github.io/tableau-mcp/docs/desktop-tools/fields/add-field): Places a field on a worksheet shelf in the open Tableau Studio workbook — the manual path for adding a field when no template binding applies. - [List Available Fields](https://tableau.github.io/tableau-mcp/docs/desktop-tools/fields/list-available-fields): Lists the datasource fields available for authoring from a live or cached workbook open in the local Tableau Studio instance — useful for field exploration, answering field questions, and non-template authoring. - [Remove Field](https://tableau.github.io/tableau-mcp/docs/desktop-tools/fields/remove-field): Removes a field from a worksheet's Rows shelf, Columns shelf, or an encoding channel by editing the worksheet's cached XML file on the local filesystem. - [Find Field Reference](https://tableau.github.io/tableau-mcp/docs/desktop-tools/fields/resolve-field): Disambiguates a field name to its exact column reference (column_ref) — the Country-vs-Country1 class of problem where a human-readable name maps to more than one underlying column. - [Search Workbook Fields](https://tableau.github.io/tableau-mcp/docs/desktop-tools/fields/search-workbook-fields): Searches fields and calculations in the workbook currently open in the connected Tableau Studio instance. - [Set Member Colors](https://tableau.github.io/tableau-mcp/docs/desktop-tools/fields/set-member-colors): Set colors for members of the discrete field on a worksheet's Color. ### Interaction > Tools for user interaction and authoring-episode lifecycle management. - [Ask the User a Clarifying Question](https://tableau.github.io/tableau-mcp/docs/desktop-tools/interaction/ask-user): Pauses to ask the human user a clarifying question instead of guessing, and stops to wait for their answer. - [Begin Episode](https://tableau.github.io/tableau-mcp/docs/desktop-tools/interaction/tableau-begin-episode): Begins a new authoring/eval episode for a Tableau Studio session and returns a generated episode_id that groups the telemetry recorded until the episode ends. - [End Episode](https://tableau.github.io/tableau-mcp/docs/desktop-tools/interaction/tableau-end-episode): Closes the current authoring/eval episode for a Tableau Studio session, recording a terminal status and any closing notes. ### Session > Tools for discovering local Tableau Studio instances and detecting user-made changes for the current session. - [Find Open Tableau Studio Windows](https://tableau.github.io/tableau-mcp/docs/desktop-tools/session/list-instances): Discovers the running local Tableau Studio instances the server can connect to and returns each one's session id, along with its loopback base URL, reported API version (when advertised), and whether an authentication token is present. - [Get Workbook State](https://tableau.github.io/tableau-mcp/docs/desktop-tools/session/get-desktop-state): Report whether Tableau Studio is idle or blocked, the strongest observed blocking cause, all active native activities, UI snapshot completeness, and visible modal or progress window content. ### Storyboards > Tools for listing, inspecting, applying, and exporting storyboards in the open workbook. - [Apply Storyboard](https://tableau.github.io/tableau-mcp/docs/desktop-tools/storyboard/apply-storyboard): Applies an edited storyboard document to the workbook open in Tableau Studio, replacing that one storyboard and leaving the workbook's other sheets intact. - [Add Storyboard](https://tableau.github.io/tableau-mcp/docs/desktop-tools/storyboard/add-storyboard): Add a blank storyboard to the open workbook. - [Export Storyboard Image](https://tableau.github.io/tableau-mcp/docs/desktop-tools/storyboard/export-storyboard-image): Renders a storyboard's active story point from the workbook open in Tableau Studio as an image. - [Compose Story](https://tableau.github.io/tableau-mcp/docs/desktop-tools/storyboard/compose-story): Sets the ordered story points of a story that already exists in the workbook open in Tableau Studio. ### Tableau Agent > Tools that control Tableau Agent chrome: refreshing auto-updates and the start-page visibility. - [Refresh Auto Updates](https://tableau.github.io/tableau-mcp/docs/desktop-tools/tableau-agent/refresh-auto-updates): Run pending automatic updates now, without changing the active sheet: for one worksheet, every worksheet in a dashboard's current device layout, or the current point of a storyboard. - [Set Start Page Visibility](https://tableau.github.io/tableau-mcp/docs/desktop-tools/tableau-agent/set-start-page-visibility): Shows or hides the Tableau Studio Start Page and returns the actual resulting visibility. ### Templates > Tools for injecting XML templates into the open workbook. - [Build Worksheet From Template](https://tableau.github.io/tableau-mcp/docs/desktop-tools/template/build-worksheets-from-templates): Builds one finished worksheet from a chart template and the fields of the workbook currently open in Tableau Studio, without changing anything in that workbook. ### Workbooks > Tools for reading and applying workbook XML, listing worksheets and dashboards, and activating sheets in the open workbook. - [Delete Sheet](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workbook/delete-sheet): Deletes a worksheet, dashboard, or storyboard from the workbook open in Tableau Studio, matching the target by name or id. - [Activate Sheet](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workbook/activate-sheet): Activates an existing worksheet, dashboard, or storyboard in the open Tableau Studio workbook, bringing it to the foreground so it becomes the active sheet (_available September 2026 and later_ for storyboards and for matching by id). - [Update Workbook](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workbook/apply-workbook): Applies modified workbook content to the workbook currently open in Tableau Studio, replacing it with the XML you supply. - [Open File](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workbook/open-file): Opens a local file in Tableau Studio by absolute path: a .twb/.twbx opens as a workbook, while a datasource file (Excel, .tds, extract, and the like) attaches to the open workbook. - [Rename Sheet](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workbook/rename-sheet): Renames a worksheet, dashboard, or storyboard in the workbook open in Tableau Studio, matching the target by name or id. - [Save Workbook](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workbook/save-workbook): Saves the workbook currently open in Tableau Studio. - [Export Workbook](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workbook/workbook-export-as): Exports the workbook open in Tableau Studio to a file at filePath, leaving the open document unchanged. - [Set Auto Updates Paused](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workbook/set-auto-updates-paused): Pause or resume automatic query execution for a worksheet, or for a dashboard and every worksheet it contains. - [Undo or Redo](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workbook/undo-redo-workbook): Undo reverses the most recent change to the open workbook (Edit > Undo). - [Get Structure](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workbook/get-xml): Read the live structure of the open workbook, or of one existing sheet or datasource. - [Publish Workbook](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workbook/publish-workbook): Opens the Publish Workbook dialog so the workbook open in the connected Tableau Studio instance can be published to the signed-in Tableau site. - [Capture Window Screenshot](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workbook/capture-window-screenshot): Capture the largest visible Tableau window by pixel area. - [Close Workbook](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workbook/close-workbook): Close the open workbook (File Close). - [Get workbook extensions](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workbook/get-workbook-extensions): Lists viz and dashboard extensions in the open workbook. - [Reload Extensions](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workbook/reload-extensions): Reload the extension on a worksheet, or every extension on a dashboard. ### Worksheets > Tools for creating, applying, refining, and deleting worksheets in the open workbook. - [Add Worksheet](https://tableau.github.io/tableau-mcp/docs/desktop-tools/worksheet/add-worksheet): Add a blank worksheet to the open workbook. - [Apply Worksheet](https://tableau.github.io/tableau-mcp/docs/desktop-tools/worksheet/apply-worksheet): Applies a worksheet to the workbook currently open in Tableau Studio. - [Sort Worksheet](https://tableau.github.io/tableau-mcp/docs/desktop-tools/worksheet/sort-worksheet): Applies or clears a sort on a field of a worksheet in the workbook open in Tableau Studio, without opening the sort dialog. - [Refine Worksheet](https://tableau.github.io/tableau-mcp/docs/desktop-tools/worksheet/refine-worksheet): Applies one bounded, validated refinement to an existing worksheet without hand-editing whole-workbook XML. - [Export Worksheet Image](https://tableau.github.io/tableau-mcp/docs/desktop-tools/worksheet/export-worksheet-image): Renders one worksheet of the workbook open in Tableau Studio as an image. - [Format Worksheets](https://tableau.github.io/tableau-mcp/docs/desktop-tools/worksheet/format-worksheets): Sets mark labels and number formats on worksheets in the workbook open in Tableau Studio. - [Get Show Me Options](https://tableau.github.io/tableau-mcp/docs/desktop-tools/worksheet/get-show-me-options): Call this before applying Show Me. - [Show Me](https://tableau.github.io/tableau-mcp/docs/desktop-tools/worksheet/show-me): Apply a Show Me option. - [Get Sheets](https://tableau.github.io/tableau-mcp/docs/desktop-tools/worksheet/get-sheets): Read the sheets in the open workbook. ### Workspace > Tools for listing and reloading workspace extensions installed in Tableau Studio. - [Get Workspace Extensions](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workspace/get-workspace-extensions): Lists the workspace extensions installed in the connected Tableau Studio instance, including disabled ones. - [Reload a Workspace Extension](https://tableau.github.io/tableau-mcp/docs/desktop-tools/workspace/reload-workspace-extension): Reloads one workspace extension from the repository Packages folder in the connected Tableau Studio instance, so a new or changed extension shows up in the Extensions menu and toolbar, and reloads any of its open pages without opening new ones. ## Enterprise Deployment - [Enterprise Deployment](https://tableau.github.io/tableau-mcp/docs/enterprise): Tableau MCP can be self-hosted on infrastructure you control. - [Tableau MCP Deployment Guide for Tableau Server Customers](https://tableau.github.io/tableau-mcp/docs/enterprise/tableau-server): This guide provides step-by-step instructions for Tableau Server customers to deploy the Tableau MCP server in a self-hosted environment. - [Tableau MCP Deployment Guide for Tableau Cloud Customers](https://tableau.github.io/tableau-mcp/docs/enterprise/tableau-cloud): This guide provides step-by-step instructions for Tableau Cloud customers to deploy the Tableau MCP server in a self-hosted environment. ## Configuration - [Configuration](https://tableau.github.io/tableau-mcp/docs/configuration): Some configuration is required to both Tableau and Tableau MCP to get the most out of the products. - [Configuring Tableau](https://tableau.github.io/tableau-mcp/docs/configuration/tableau-config): Tableau MCP is a bridge between an AI agent and your Tableau Platform (APIs). ### Configuring Tableau MCP - [Configuring Tableau MCP](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config): The Tableau MCP server makes use of environment variables to configure its behavior. - [Environment Variables](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/env-vars): Values for the following environment variables can be provided to configure the Tableau MCP server. - [Enabling OAuth (Tableau Server)](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/oauth): These docs are for enabling OAuth for Tableau Server only. - [HTTP Server](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/http-server): The Tableau MCP server can be configured to run as an HTTP server, leveraging the Streaming HTTP MCP transport. - [Tool Scoping](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/tool-scoping): The Tableau MCP server can be configured to limit the scope of its tools to a set of data sources, workbooks, views, projects, or tags. - [Site Settings](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/site-settings): Tableau MCP supports configuration on a per-site basis via REST API. - [Request Overrides](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/request-overrides): Tableau MCP supports overriding certain configuration variables on a per-request basis via an HTTP header. - [Running Multiple Servers & Diagnosing Auth Errors](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/multiple-servers): You can configure more than one Tableau MCP server in the same client (for example a production site, a stage site, and a local build). - [MCP Configuration for Site Administrators](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/site-administrators): This page is a guide for Tableau **site and server administrators** who are responsible for securing and governing a Tableau MCP deployment, and for customizing MCP guardrails for your organization. - [Configure a Local Tableau MCP Service](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/configure-local-service): This page is a guide for individual users running Tableau MCP **locally** — as a stdio server launched by your AI tool (MCP client) via npx, node, or Docker. - [Authentication](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/authentication): Tableau MCP requires authentication in order to connect with your Tableau Server or Tableau Cloud site. - [Personal Access Token](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/authentication/pat): Tableau [Personal Access Tokens (PAT)][pat] enable users to utilize Tableau REST APIs without requiring hard-coded credentials (username and password) or interactive sign-in. - [Direct Trust](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/authentication/direct-trust): When AUTH is direct-trust, the MCP server will use the provided [Tableau Direct Trust Connected App][direct-trust] info to generate a scoped [JSON Web Token (JWT)][jwt] and use it to authenticate to the Tableau REST APIs. - [Unified Access Tokens](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/authentication/uat): When AUTH is uat, the MCP server will use the provided [Tableau Unified Access Token (UAT)][uat] info to generate a scoped JSON Web Token (JWT) and use it to authenticate to the Tableau REST APIs. - [OAuth](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/authentication/oauth): https://mcp.tableau.com is Tableau's hosted version of Tableau MCP. - [Passthrough Authentication](https://tableau.github.io/tableau-mcp/docs/configuration/mcp-config/authentication/passthrough): With passthrough authentication enabled, authentication to the MCP server acts similarly to the Tableau REST APIs. ## Developers - [Developers](https://tableau.github.io/tableau-mcp/docs/developers): Information for developers working on or using the Tableau MCP project, including building from source, testing, debugging, contributing, and using development tools. - [MCP Inspector](https://tableau.github.io/tableau-mcp/docs/developers/mcp-inspector): The [MCP Inspector][mcp-inspector] is a helpful tool to confirm your configuration is correct and to explore Tableau MCP capabilities. - [Contributing](https://tableau.github.io/tableau-mcp/docs/developers/contributing): We are following the fork and pull model where contributors will make their own fork of this repo, implement their changes, and then submit a pull request here. - [Debugging](https://tableau.github.io/tableau-mcp/docs/developers/debugging): The easiest way to debug is to set TRANSPORT to http and run npm run start:http from the JavaScript Debug Terminal in VS Code / Cursor. - [Unit Tests](https://tableau.github.io/tableau-mcp/docs/developers/unit-tests): The Tableau MCP project uses [Vitest][vitest] for unit testing. - [E2E Tests](https://tableau.github.io/tableau-mcp/docs/developers/e2e-tests): The Tableau MCP project uses [Vitest][vitest] for end-to-end (E2E) testing. - [Eval Tests](https://tableau.github.io/tableau-mcp/docs/developers/eval-tests): The Tableau MCP project uses [Vitest][vitest] for eval tests. - [Feature Flags](https://tableau.github.io/tableau-mcp/docs/developers/feature-flags): Control available features during development via features.json or a cloud-based feature flag service. ## Prompts - [Prompts](https://tableau.github.io/tableau-mcp/docs/prompts): Guided admin prompts that orchestrate multiple tools. - [Stale Content Cleanup — Inform](https://tableau.github.io/tableau-mcp/docs/prompts/stale-content-cleanup-inform): stale-content-cleanup-inform - [Stale Content Cleanup — Apply](https://tableau.github.io/tableau-mcp/docs/prompts/stale-content-cleanup-apply): stale-content-cleanup-apply - [Job Optimization — Inform](https://tableau.github.io/tableau-mcp/docs/prompts/job-optimization-inform): job-optimization-inform - [Extract Refresh Optimization — Apply](https://tableau.github.io/tableau-mcp/docs/prompts/extract-optimization-apply): extract-optimization-apply - [User License Reclamation — Inform](https://tableau.github.io/tableau-mcp/docs/prompts/user-license-reclamation-inform): user-license-reclamation-inform - [User License Reclamation — Apply](https://tableau.github.io/tableau-mcp/docs/prompts/user-license-reclamation-apply): user-license-reclamation-apply ## Tableau Authoring - [Tableau Authoring](https://tableau.github.io/tableau-mcp/docs/tableau-authoring): For authoring, the November 2026 (2026.3.1) release Tableau MCP ships with more than a set of **Desktop Tools**. ## Extras - [Extras](https://tableau.github.io/tableau-mcp/docs/extras): Extra packaging and deployment options beyond the usual npm, source, and Docker getting-started paths. - [Docker](https://tableau.github.io/tableau-mcp/docs/extras/docker): See [Tableau MCP Docker Container][link] for installation instructions. - [Node.js Single Executable Applications](https://tableau.github.io/tableau-mcp/docs/extras/node-sea): Node.js Single Executable Applications (SEA) are a way to package a Node.js application into a single executable file. - [Deploy to Heroku](https://tableau.github.io/tableau-mcp/docs/extras/deploy-heroku): This project now includes experimental support for Heroku. - [Tableau Cloud IP Filtering](https://tableau.github.io/tableau-mcp/docs/extras/ip-filtering): If your Tableau Cloud site restricts access by IP address (Tableau Cloud IP filtering), hosted Tableau MCP needs two changes before it can reach the site: ## Privacy Policy - [Privacy Policy](https://tableau.github.io/tableau-mcp/docs/privacy): Review our [Privacy Policy][privacy-policy] regarding how we handle data. ## Optional - [llms-full.txt](https://tableau.github.io/tableau-mcp/llms/llms-full.txt): contract full text of every published page - [GitHub repository](https://github.com/tableau/tableau-mcp): source for Tableau MCP - [Hosted Tableau MCP](https://mcp.tableau.com): managed MCP endpoint on Tableau Cloud - [Model Context Protocol](https://modelcontextprotocol.io/introduction): the protocol this server implements