Skip to content
MCP server

Tableau Graphql MCP

Answer Tableau lineage and impact questions through the Metadata API

Runs locallyStatus and history
Install
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-mcp

Add 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)Required
  • TABLEAU_SITE_CONTENT_URLSite content-url slug; empty = Default site (Server only)
  • TABLEAU_PAT_NAMEPersonal Access Token nameRequired
  • TABLEAU_PAT_SECRETPersonal Access Token secret (the whole string)Required
  • TABLEAU_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.

How AIPoweredBot checks servers