Tableau Graphql MCP
Answer Tableau lineage and impact questions through the Metadata API
- Pricing
- Open source
- Platforms
- CLI, macOS, Windows
- Runs
- Locally
- Version
- 0.2.0
- Listing updated
- today
Similar MCP servers
About Tableau Graphql MCP
Tableau Graphql MCP is an open-source MCP server for analytics and data. It runs locally on your machine and is started by your AI client.
Seven read-only tools turn a Tableau site's Metadata API into something an assistant can question. graphql_query runs any read-only GraphQL, introspect_schema inspects the live schema, and lineage_examples provides a cheat-sheet with 28 worked query templates in eight categories. where_used resolves which workbooks and datasources use given columns, fields or tables, and search_content finds content by name with scanned and total coverage numbers.
impact_analysis follows dependencies across multiple hops, including a calculation built on another calculation built on a column, and returns affected sheets, dashboards, workbooks and the owners to notify. It works with Tableau Server and Tableau Cloud, and the REST version and GraphQL endpoint are auto-detected. where_used does not depend on the Catalog add-on.
It signs in with a personal access token, runs over stdio, and rejects mutations. Partial results are flagged instead of passed off as complete. Plain http servers are refused unless you opt in.
Install
Run in a terminal
claude mcp add tableau-graphql-mcp --env TABLEAU_SERVER='<TABLEAU_SERVER>' --env TABLEAU_PAT_NAME='<TABLEAU_PAT_NAME>' --env TABLEAU_PAT_SECRET='<TABLEAU_PAT_SECRET>' -- uvx tableau-graphql-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"tableau-graphql-mcp": {
"command": "uvx",
"args": [
"tableau-graphql-mcp"
],
"env": {
"TABLEAU_SERVER": "<TABLEAU_SERVER>",
"TABLEAU_PAT_NAME": "<TABLEAU_PAT_NAME>",
"TABLEAU_PAT_SECRET": "<TABLEAU_PAT_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tableau-graphql-mcp": {
"command": "uvx",
"args": [
"tableau-graphql-mcp"
],
"env": {
"TABLEAU_SERVER": "<TABLEAU_SERVER>",
"TABLEAU_PAT_NAME": "<TABLEAU_PAT_NAME>",
"TABLEAU_PAT_SECRET": "<TABLEAU_PAT_SECRET>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tableau-graphql-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"tableau-graphql-mcp"
],
"env": {
"TABLEAU_SERVER": "<TABLEAU_SERVER>",
"TABLEAU_PAT_NAME": "<TABLEAU_PAT_NAME>",
"TABLEAU_PAT_SECRET": "<TABLEAU_PAT_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tableau-graphql-mcp": {
"command": "uvx",
"args": [
"tableau-graphql-mcp"
],
"env": {
"TABLEAU_SERVER": "<TABLEAU_SERVER>",
"TABLEAU_PAT_NAME": "<TABLEAU_PAT_NAME>",
"TABLEAU_PAT_SECRET": "<TABLEAU_PAT_SECRET>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tableau-graphql-mcp": {
"command": "uvx",
"args": [
"tableau-graphql-mcp"
],
"env": {
"TABLEAU_SERVER": "<TABLEAU_SERVER>",
"TABLEAU_PAT_NAME": "<TABLEAU_PAT_NAME>",
"TABLEAU_PAT_SECRET": "<TABLEAU_PAT_SECRET>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
TABLEAU_SERVERhttps://tableau.company.com (Server) or https://<pod>.online.tableau.com (Cloud)RequiredTABLEAU_SITE_CONTENT_URLSite content-url slug; empty = Default site (Server only)TABLEAU_PAT_NAMEPersonal Access Token nameRequiredTABLEAU_PAT_SECRETPersonal Access Token secret (the whole string)RequiredTABLEAU_LOG_LEVELDEBUG, INFO (default), WARNING or ERROR; DEBUG logs each HTTP call (method + URL) to stderr
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- graphql_query
- Run any read-only Metadata API GraphQL query.
- introspect_schema
- Live schema introspection.
- lineage_examples
- Schema cheat-sheet and 28 query templates.
- where_used
- Find workbooks and datasources using given names.
- impact_analysis
- Multi-hop blast radius with owners to notify.
- search_content
- Case-insensitive name search across content.
- server_info
- Connected server, site, versions and lineage availability.
What it does
- Any lineage query
- graphql_query passes through any read-only Metadata API query.
- Multi-hop impact
- Full blast radius with owners to notify.
- Where-used lookup
- Find workbooks using given columns or tables.
- Content search
- Substring search with coverage counts.
- Server and Cloud
- Works on both, with endpoints auto-detected.
- Read-only by design
- Mutations and subscriptions are rejected.
Good for
- See which workbooks break if a column is dropped
- List who to notify before changing a warehouse table
- Map calculated fields to their source columns
- Find uncertified datasources feeding a project
Pricing
Open source
Open source Python package; requires a Tableau site
Tableau Graphql MCP FAQ
What credentials does it need?
A Tableau server URL and a personal access token name and secret.
Can it change my Tableau content?
No. The Metadata API is query-only and mutations are rejected.
Does it need the Catalog add-on?
No, where_used works through core lineage even without it.
How do I install it?
Run it with uvx tableau-graphql-mcp, for example via claude mcp add.
Is Tableau Graphql MCP free?
Yes. Tableau Graphql MCP is open source, so you can use and self-host it for free.
How do I add Tableau Graphql MCP to Claude Code?
Run this command in your terminal: claude mcp add tableau-graphql-mcp --env TABLEAU_SERVER='<TABLEAU_SERVER>' --env TABLEAU_PAT_NAME='<TABLEAU_PAT_NAME>' --env TABLEAU_PAT_SECRET='<TABLEAU_PAT_SECRET>' -- uvx tableau-graphql-mcp
What are the best alternatives to Tableau Graphql MCP?
The closest alternatives to Tableau Graphql MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons, Tapetide - Indian Stock Market MCP and World Monitor.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

