Get Workbook
Retrieves information about a single workbook, including the views it contains and their usage statistics. When Metadata API access is enabled, the result is also enriched with the workbook's upstream data-source lineage.
APIs called
This tool reads from the Tableau REST API (Tableau Cloud or Server) and, unless disabled, enriches
the result with the Tableau Metadata API (GraphQL). The MCP-layer OAuth scope is
tableau:mcp:workbook:read; across its calls it requires the tableau:content:read and
tableau:mcp_site_settings:read OAuth scopes.
- Confirm the caller is allowed to access the requested workbook before returning it, honoring any
configured content bounded-context / allow-list. Issued against the Tableau REST API; requires the
tableau:content:readandtableau:mcp_site_settings:readOAuth scopes. This check may itself read the workbook via the Query Workbook call below. - Retrieve the workbook's metadata (name, project, tags, default view, and its views). Issued against
the Tableau REST API; requires the
tableau:content:readOAuth scope.GET /api/{version}/sites/{siteId}/workbooks/{workbookId}— return the workbook's details. Query Workbook
- Fetch each view's usage statistics and merge them into the workbook's views. Issued against the
Tableau REST API; requires the
tableau:content:readOAuth scope.GET /api/{version}/sites/{siteId}/workbooks/{workbookId}/views?includeUsageStatistics=true— return the workbook's views with usage counts. Query Views for Workbook
- Enrich the workbook with its upstream data-source lineage, unless
DISABLE_METADATA_API_REQUESTS=true. Issued against the Tableau Metadata API (GraphQL); requires thetableau:content:readOAuth scope.POST /api/metadata/graphql— run a GraphQL query for the workbook's upstream data sources. Metadata API
The lineage step is best-effort: if the Metadata API request fails, the tool logs a warning and returns the workbook without lineage rather than failing the request.
Required arguments
workbookId
The ID of the workbook, potentially retrieved by the List Workbooks tool.
Example: 222ea993-9391-4910-a167-56b3d19b4e3b
Example result
{
"id": "222ea993-9391-4910-a167-56b3d19b4e3b",
"name": "Superstore",
"webpageUrl": "https://10ax.online.tableau.com/#/site/mcp-test/workbooks/1412200",
"contentUrl": "Superstore",
"project": {
"name": "Samples",
"id": "cbec32db-a4a2-4308-b5f0-4fc67322f359"
},
"showTabs": true,
"defaultViewId": "9460abfe-a6b2-49d1-b998-39e1ebcc55ce",
"tags": {},
"views": {
"view": [
{
"id": "9460abfe-a6b2-49d1-b998-39e1ebcc55ce",
"name": "Overview",
"createdAt": "2025-09-02T23:25:58Z",
"updatedAt": "2025-09-02T23:25:58Z",
"tags": {},
"totalViewCount": 165
}
]
}
}
Related
list-workbooks— list the workbooks on a site to obtain aworkbookId