Log inSubmit server
Tableau Graphql MCP logo

Tableau Graphql MCP

Ask Tableau lineage questions through read-only Metadata API GraphQL tools in any MCP client.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Tableau Graphql MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "tableau-graphql-mcp": {
      "command": "uvx",
      "args": [
        "tableau-graphql-mcp"
      ],
      "env": {
        "TABLEAU_SERVER": "YOUR_VALUE_HERE",
        "TABLEAU_SITE_CONTENT_URL": "YOUR_VALUE_HERE",
        "TABLEAU_PAT_NAME": "YOUR_VALUE_HERE",
        "TABLEAU_PAT_SECRET": "YOUR_VALUE_HERE",
        "TABLEAU_AUTH_TOKEN": "YOUR_VALUE_HERE",
        "TABLEAU_COOKIE": "YOUR_VALUE_HERE",
        "TABLEAU_TIMEOUT": "YOUR_VALUE_HERE",
        "TABLEAU_API_VERSION": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 7 tools correctly (6d ago).

Overview

The tableau-graphql-mcp MCP server exposes Tableau Server and Tableau Cloud Metadata API capabilities through read-only MCP tools. It can run arbitrary GraphQL queries, inspect the live schema, search content, resolve one-hop usage, and calculate multi-hop impact with affected owners. Reach for it when an AI assistant needs lineage, dependency, or change-impact answers from a Tableau site. Configuration uses environment variables and supports stdio clients including Claude, Cursor, Cline, and Windsurf.

Use cases

  • Trace which workbooks use a column or table
  • Calculate the blast radius of changing a field
  • Find Tableau content by a case-insensitive name search
  • Inspect Metadata API schema fields and query templates
  • Identify owners to notify before a data change

Key features

  • Read-only Metadata API GraphQL queries
  • Live schema introspection
  • Multi-hop impact analysis
  • Core-lineage where-used resolution
  • Coverage-aware Tableau content search
  • Server and Catalog status inspection

Tools7

What Tableau Graphql MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.6k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

7/7 checks healthy over the last 45d

What it can do

From the 7 tools this server returned when we ran it; 7 declare their own safety hints.

Makes network requests · 6Read-only tools · 7
Network at startup2 connections
Files written at startup30

Observed 2026-10-17 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · tableau-graphql-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
Last commit5d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed7Callable tools this server registers over MCP.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Tableau Graphql MCP works

What tableau-graphql-mcp MCP server does

The tableau-graphql-mcp MCP server connects an MCP client to a Tableau site's Metadata API. It is designed for lineage and dependency questions about workbooks, dashboards, sheets, datasources, tables, fields, and columns. All exposed operations are read-only; the server does not modify Tableau content.

Its general-purpose graphql_query tool accepts read-only Metadata API GraphQL queries. Supporting tools help an AI assistant form and validate those queries: introspect_schema exposes available entry points and exact fields, while lineage_examples provides a schema reference and 28 question-to-query templates across eight categories.

How it works

The server authenticates to Tableau Server or Tableau Cloud, discovers the REST API version when needed, and locates the Metadata API GraphQL endpoint automatically. It uses /api/metadata/graphql by default through detection, with a relationship-service fallback available. A configured site content URL selects the Tableau site; an empty value targets the default Server site, while Cloud requires a site.

For common lineage tasks, where_used resolves workbooks and datasources associated with supplied column, field, or table names. impact_analysis follows dependencies across multiple hops, then reports affected fields, sheets, dashboards, workbooks, and deduplicated owners to notify. search_content performs case-insensitive substring matching and reports scan coverage, while server_info confirms connection details, versions, endpoint, authentication mode, and Catalog lineage availability.

Setup and configuration

Install uv, then run the tableau-graphql-mcp MCP server with uvx tableau-graphql-mcp; uvx retrieves the package from PyPI in an isolated environment. Add the command and its environment variables to the MCP client's server configuration.

Set TABLEAU_SERVER to the Tableau Server or Cloud URL. Authentication normally requires both TABLEAU_PAT_NAME and TABLEAU_PAT_SECRET; alternatively, advanced deployments can provide TABLEAU_AUTH_TOKEN or TABLEAU_COOKIE. TABLEAU_SITE_CONTENT_URL is optional for Server's default site and required for Cloud. TABLEAU_TIMEOUT, TABLEAU_API_VERSION, and TABLEAU_METADATA_PATH provide optional request, version, and endpoint overrides.

Keep secrets in the client's environment block rather than passing them on the command line. The process uses stdio and does not open an inbound port.

Tools and capabilities

  • graphql_query: execute any read-only Metadata API GraphQL query.
  • introspect_schema: list schema entry points or fields for a named type.
  • lineage_examples: retrieve the embedded schema cheat-sheet and query templates.
  • where_used: find workbook or datasource usage for supplied names.
  • impact_analysis: calculate transitive dependency effects and owners to notify.
  • search_content: search names across supported Tableau content types, optionally including fields and columns.
  • server_info: inspect the connected Tableau environment and Catalog lineage status.

Limitations and notes

The tableau-graphql-mcp MCP server depends on the Tableau Metadata API and the permissions available to its configured credentials. Catalog-specific availability is reported by server_info; core lineage resolution lets where_used work even when Catalog's downstream workbook data is empty. GraphQL responses can reach node limits, in which case graphql_query marks partial results. Search results include scanned and total coverage so incomplete scans can be identified.

The server is read-only and intended for querying lineage rather than changing Tableau objects. Its documented transport is stdio, and the package uses the MCP SDK with Python standard-library HTTP support.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Tableau Graphql MCP

tableau-graphql-mcp is an MCP server that connects AI clients to the Tableau Server or Tableau Cloud Metadata API. Its main tools run read-only GraphQL queries, inspect the schema, search content, resolve where-used lineage, calculate multi-hop impact, provide query examples, and report connection details.

Install it with uv and run `uvx tableau-graphql-mcp` in your MCP client configuration. The package is fetched from PyPI into an isolated environment, so cloning the repository is not required.

Set `TABLEAU_SERVER` and authenticate with either `TABLEAU_PAT_NAME` plus `TABLEAU_PAT_SECRET`, or an advanced `TABLEAU_AUTH_TOKEN` or `TABLEAU_COOKIE`. `TABLEAU_SITE_CONTENT_URL` is required for Tableau Cloud and optional for a Server default site.

Yes, tableau-graphql-mcp works with Cursor through its MCP server configuration.

No, tableau-graphql-mcp exposes read-only tools. Its GraphQL queries, lineage analysis, content search, schema inspection, and connection probe retrieve information from the Tableau Metadata API without mutations.

Related MCP servers

All in Data Visualization All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewTableau Graphql MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/tableau-graphql-mcp?style=directory)](https://allmcps.com/mcp/tableau-graphql-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/tableau-graphql-mcp"><img src="https://allmcps.com/api/badge/tableau-graphql-mcp?style=directory" alt="Tableau Graphql MCP on AllMCPs" /></a>