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. Pass the custom view LUID (from the content URL), not the published view id. For a published view without a custom view, use Get View Data with the view id instead.
APIs called
Talks to the Tableau REST API (Tableau Cloud or Server). Gated by the tableau:mcp:view:download
MCP scope; across the operations below it needs the tableau:views:download and
tableau:content:read OAuth scopes (plus tableau:mcp_site_settings:read).
- Download the custom view rendered as CSV.
GET /api/{version}/sites/{siteId}/customviews/{customViewId}/data— return the custom view's data as CSV, applying anyviewFilters. Issued against the Tableau REST API; requires thetableau:views:downloadOAuth scope. Get Custom View Data
- When tool scoping is enabled, resolve the custom
view to its underlying published view and check it against the configured allow-lists.
GET /api/{version}/sites/{siteId}/customviews/{customViewId}— resolve the underlying view id. Issued against the Tableau REST API; requires thetableau:content:readOAuth scope (plustableau:mcp_site_settings:read). Get Custom ViewGET /api/{version}/sites/{siteId}/views/{viewId}— verify the resolved view is within the allowed projects, workbooks, views, and tags. Issued against the Tableau REST API; requires thetableau:content:readOAuth scope (plustableau:mcp_site_settings:read). Get View
Required arguments
customViewId
The LUID of the custom view, potentially retrieved by the List Custom Views tool. This is the custom view LUID from the content URL, not the published view id.
Example
{ "customViewId": "1db3a121-51ac-4435-b533-3053e698dfc8" }
Optional arguments
viewFilters
Map of view filter field names to values. The vf_ prefix for field names is optional and will be
added automatically when building the view filter query.
Example
{ "viewFilters": { "year": "2017" } }
Example result
Country/Region,State/Province,Profit Ratio,Latitude (generated),Longitude (generated)
Canada,Ontario,26.8%,50.94,-84.75
Related
get-view-data— download CSV data for a published view by its view idget-custom-view-image— render a custom view as an imagelist-custom-views— find custom view LUIDs on the site
Response behavior
The tool returns one of two result shapes:
MCP_S3_BUCKETunset (default): returns the CSV as a single JSON-encoded text string (JSON.stringify(csv)), with newlines escaped as\n.MCP_S3_BUCKETset: returns aresource_linkwith a short-lived presigned URL to the CSV file in S3, instead of inlining the data.
Example result (default)
"Country/Region,State/Province,Profit Ratio,Latitude (generated),Longitude (generated)\nCanada,Ontario,26.8%,50.94,-84.75\n"
Example result (S3 mode)
{
"type": "resource_link",
"uri": "https://example-bucket.s3.amazonaws.com/...presigned...",
"name": "view-data.csv",
"mimeType": "text/csv",
"description": "View data (CSV) stored in S3. This is a short-lived presigned URL."
}