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. When results include workbooks or views, the tool also enriches them with their upstream published datasources.
APIs called
This tool talks to the Tableau REST API (Tableau Cloud or Server). The MCP-layer OAuth gate requires
the tableau:mcp:content:read scope; the union of Tableau API scopes across all calls is
tableau:content:read and tableau:mcp_site_settings:read (the latter is used to read this site's
MCP configuration overrides).
- Search across all supported content types for items relevant to the terms and filters, honoring
the configured result cap.
GET /api/-/search— run the content search. Issued against the Tableau REST API Content Exploration methods; requires thetableau:content:readOAuth scope. Get Content Search Results
- Enrich workbook and view results with their upstream published datasources. Skipped when
DISABLE_METADATA_API_REQUESTSistrue.POST /api/metadata/graphql— fetch upstream datasource lineage for the returned workbooks and views. Issued against the Tableau Metadata API (GraphQL); requires thetableau:content:readOAuth scope. Tableau Metadata API
Optional arguments
terms
A string containing one or more search terms that the search uses as the basis for determining which items are relevant to return. If the terms parameter is not provided, it searches for everything bound by the specified filters.
Example
"Regional Sales"
limit
The number of items to return in the search response. Default limit is 100 and max value is 2000
items. The effective limit is capped by any configured
MAX_RESULT_LIMIT, so the smaller of
the two is used.
See also: MAX_RESULT_LIMIT
Example
100
orderBy
Determines the sorting method for returned items. Available sorting methods:
hitsTotal: Number of times a content item has been viewed since it was createdhitsSmallSpanTotal: Number of times a content item was viewed in the last monthhitsMediumSpanTotal: Number of times a content item was viewed in the last 3 monthshitsLargeSpanTotal: Number of times a content item was viewed in the last yeardownstreamWorkbookCount: Number of workbooks in a given project. This value is only available when the content type filter includes 'database' or 'table'
For each sort method, you can specify a sort direction: "asc" for ascending or "desc" for
descending (default: "asc").
The orderBy parameter is an array of objects containing the sorting method and direction. The
first element determines primary sorting, with subsequent elements used as tiebreakers.
If the orderBy parameter is omitted, the search will sort items by their "relevance score" in
descending order, which is Tableau's internal algorithm for providing the most relevant results.
Example
[
{
"method": "hitsSmallSpanTotal",
"sortDirection": "desc"
},
{
"method": "hitsMediumSpanTotal",
"sortDirection": "desc"
}
]
filter
An object that allows you to limit search results based on:
contentTypes: Filter by content types (array of strings). Supported types are:lens,datasource,virtualconnection,collection,project,flow,datarole,table,database,view,workbookownerIds: Filter by specific owner IDs (array of integers)modifiedTime: Filter by last modified times using ISO 8601 date-time strings. Can be either a range (with startDate/endDate) or an array of specific date-times to include
The filter parameter is optional, but if it is provided it requires at least one of the three
filtering methods (contentTypes, ownerIds, or modifiedTime).
Example
{
"contentTypes": ["workbook", "datasource"],
"modifiedTime": {
"startDate": "2025-01-01T00:00:00.000Z"
}
}
Example
{
"ownerIds": [12345, 67890],
"modifiedTime": [
"2025-02-01T20:01:03Z",
"2024-11-15T14:23:07Z",
"2024-12-08T09:45:33Z",
"2025-01-22T16:12:58Z",
"2025-03-07T11:37:21Z",
"2025-04-18T20:55:14Z"
]
}
Notes and caveats
- Lineage enrichment is best-effort: if the Metadata API request fails, the failure is logged and the search results are still returned without upstream datasource details.
Example result
[
{
"modifiedTime": "2025-09-19T18:52:18.475Z",
"type": "workbook",
"ownerId": 325277,
"title": "Income Trends with Age",
"ownerName": "Lucia Orange",
"containerName": "Research",
"luid": "d9870a9b-4934-4ebc-a9ee-5fc723c79590",
"totalViewCount": 3061,
"favoritesTotal": 1,
"viewCountLastMonth": 105,
"hasExtracts": true,
"extractCreationPending": false
},
{
"modifiedTime": "2025-08-28T20:11:05.699Z",
"sheetType": "dashboard",
"workbookDescription": "This dashboard contains KPIs for e bike manufactures within our network.",
"type": "view",
"ownerId": 461938,
"title": "Manufacturer Overview",
"ownerName": "Maria Stone",
"parentWorkbookName": "eBikes Analytics",
"luid": "b4457c0b-5eeb-4cbc-b1ae-47ed1d90cee7",
"locationName": "2025 Reports",
"totalViewCount": 3991,
"favoritesTotal": 7,
"projectName": "2025 Reports",
"viewCountLastMonth": 567
},
{
"modifiedTime": "2025-09-24T20:10:35.437Z",
"type": "datasource",
"ownerId": 411957,
"title": "Test Report Data",
"ownerName": "Bruce Springtail",
"containerName": "Data Sources",
"luid": "a9af708b-0d44-48f8-23e2-4ee4b12446b2",
"totalViewCount": 42260,
"favoritesTotal": 3,
"viewCountLastMonth": 1947,
"isConnectable": true,
"datasourceIsPublished": true,
"connectionType": "snowflake",
"isCertified": false,
"hasExtracts": true,
"extractRefreshedAt": "2025-09-24T20:10:35.385Z",
"extractUpdatedAt": "2025-09-24T20:10:35.385Z",
"connectedWorkbooksCount": 228,
"extractCreationPending": false,
"hasSevereDataQualityWarning": false,
"hasActiveDataQualityWarning": false
}
]
Environment variables
-
When set, the tool skips the Metadata API lineage-enrichment call and
upstreamDatasourcesis omitted fromworkbook/viewresults.
Worked example
workbook and view results may also include an upstreamDatasources array (each entry
{ "luid": "...", "name": "..." }) when lineage enrichment succeeds — see APIs called.