# Tableau Graphql MCP

> Tableau Graphql MCP is an open-source MCP server for analytics and data. Answer Tableau lineage and impact questions through the Metadata API. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/tdries/tableau-graphql-mcp
- **MCP Registry name:** io.github.tdries/tableau-graphql-mcp
- **Categories:** [analytics and data](https://ai-powered.com/categories/analytics-and-data)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [dashboard-icons](https://ai-powered.com/mcp/dashboard-icons): dashboard-icons is an open-source MCP server for analytics and data.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [DataArcus for Power BI](https://ai-powered.com/mcp/dataarcus-for-power-bi): DataArcus for Power BI is a free MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [Pypi Stats](https://ai-powered.com/mcp/pypi-stats): Pypi Stats is a freemium MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/tableau-graphql-mcp
