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. Supports optional filter expressions for precise, flexible view
discovery.
APIs called
This tool talks to the Tableau REST API (Tableau Cloud or Server) to list the site's views, then
enriches each view with lineage metadata from the Metadata API (GraphQL). The MCP-layer OAuth
gate requires the tableau:content:read OAuth scope plus tableau:mcp_site_settings:read to read
per-site MCP configuration overrides when MCP site settings are enabled.
- List the site's views. Retrieves views with usage statistics, paginating automatically until
all views are returned or the
limitargument is reached.GET /api/{version}/sites/{siteId}/views— retrieve a page of views for the site. Issued against the Tableau REST API; requires thetableau:content:readOAuth scope. Query Views for Site
- Enrich views with lineage metadata. Looks up upstream lineage for the returned views to
attach datasource context. Skipped when no views are found or when
DISABLE_METADATA_API_REQUESTS=true; if the lookup fails, the tool logs a warning and returns the views without lineage enrichment.POST /api/metadata/graphql— query upstream lineage for the returned views. Issued against the Metadata API (GraphQL); requires thetableau:content:readOAuth scope. Metadata API
Optional arguments
filter
A filter expression as defined in the Tableau REST API Views filter fields.
Example: name:eq:Overview
pageNumber
Which 1000-item page to fetch (1-based, default 1).
limit
The maximum number of views to return. The tool will return at most this many views.
Example: 2000
See also: MAX_RESULT_LIMIT
Example result
[
{
"id": "9460abfe-a6b2-49d1-b998-39e1ebcc55ce",
"name": "Overview",
"createdAt": "2025-09-02T23:25:58Z",
"updatedAt": "2025-09-02T23:25:58Z",
"workbook": {
"id": "222ea993-9391-4910-a167-56b3d19b4e3b"
},
"owner": {
"id": "d2a1e1df-af8e-4f43-a4cc-34858b7f8b69"
},
"project": {
"id": "cbec32db-a4a2-4308-b5f0-4fc67322f359"
},
"tags": {},
"usage": {
"totalViewCount": 0
}
}
]
Worked example
The response fields are:
data: the views on the requested page (at most 1000, or fewer whenlimitor a server cap applies).totalAvailable: the number of views available for pagination, never more than a server cap. Your ownlimitargument does not affect this value.mcp.resultInfo: present only when a server cap hides views:{ returnedCount, truncated: true, truncationReason: "admin-cap" }.returnedCountis the number of items indata.
Arguments no longer accepted
These arguments were described on an earlier page and are not accepted by the current tool.
pageSize
The value of the page-size argument provided to the
Query Views for Site
REST API. The tool automatically performs pagination and will repeatedly call the REST API until
either all views are retrieved or the limit argument has been reached. The pageSize argument
will determine how many views to return in each call. You may want to provide a larger value if you
know in advance that you have more than 100 views to retrieve.
Example: 1000