Tableau MCP

1 # Tableau MCP
2 
3[![Tableau Supported](https://img.shields.io/badge/Support%20Level-Tableau%20Supported-53bd92.svg)](https://www.tableau.com/support-levels-it-and-developer-tools)
4 
5[![Build and Test](https://github.com/tableau/tableau-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/tableau/tableau-mcp/actions/workflows/ci.yml)
6 
7[![npm](https://img.shields.io/npm/v/@tableau/mcp-server)](https://www.npmjs.com/package/@tableau/mcp-server)
8 
9## Overview
10 
11Tableau MCP is a suite of developer primitives, including tools, resources and prompts, that will
12make it easier for developers to build AI applications that integrate with Tableau.
13 
14## Official Documentation
15 
16https://tableau.github.io/tableau-mcp/
17 
18## Getting Started
19 
20### Hosted Tableau MCP (Recommended for Tableau Cloud)
21 
22Tableau MCP is available as a managed service at **`https://mcp.tableau.com`**. It uses OAuth 2.1 so every user signs in with their own Tableau Cloud identity, and all existing per-user permissions are enforced automatically.
23 
24Point any MCP-compatible client at `https://mcp.tableau.com` and complete the OAuth sign-in flow when prompted.
25 
26See [Popular Client Integrations](https://tableau.github.io/tableau-mcp/docs/hosted-tableau-mcp/client-integrations) for step-by-step setup instructions for Slack, Claude, ChatGPT, and other common AI clients.
27 
28> **Tableau Server customers** and Cloud customers who require self-hosted infrastructure should see the [Enterprise Deployment](https://tableau.github.io/tableau-mcp/docs/enterprise) and [Self-Hosted Getting Started](https://tableau.github.io/tableau-mcp/docs/getting-started) guides.
29 
30### Self-Hosted / Local (npx)
31 
32The quickest way to run Tableau MCP locally. Requires [Node.js](https://nodejs.org/en/download) 22.7.5 or later — no cloning or building needed. Configure your AI tool (MCP client) with:
33 
34```json
35{
36  "mcpServers": {
37    "tableau": {
38      "command": "npx",
39      "args": ["-y", "@tableau/mcp-server@latest"],
40      "env": {
41        "SERVER": "https://my-tableau-server.com",
42        "SITE_NAME": "my_site",
43        "PAT_NAME": "my_pat",
44        "PAT_VALUE": "pat_value"
45      }
46    }
47  }
48}
49```
50 
51For Docker, building from source, and other self-hosted options, see the [Getting Started guide](https://tableau.github.io/tableau-mcp/docs/getting-started).
52 
53## Deploy to Heroku
54 
55[![Deploy to Heroku](https://www.herokucdn.com/deploy/button.svg)](https://www.heroku.com/deploy?template=https://github.com/tableau/tableau-mcp)
56 
57## Example Prompts to Client
58 
59#### Prompt #1: Querying Data
60 
61```
62For the Superstore Datasource, what are the top 5 states with the most sales in 2025?
63```
64 
65#### Response
66 
67```
68Based on the Superstore Datasource, here are the top 5 states with the most sales in 2025:
69  1. California - $146,388.34
70  2. New York - $93,922.99
71  3. Washington - $65,539.90
72  4. Texas - $43,421.76
73  5. Pennsylvania - $42,688.31
74California leads by a significant margin with over $146,000 in sales, followed by New York with nearly $94,000. These two states alone account for a substantial portion of the total sales across the top 5 states.
75```
76 
77#### Prompt #2: Content Exploration
78 
79```
80Find me the most viewed workbook within the last year.
81```
82 
83#### Response
84 
85```
86The most viewed workbook within the last year is:
87 
88Global Connections
89- Owner: John Doe
90- Project: Marketing
91- Views in last year: 523
92- Last Modified: September 2, 2025
93- Workbook ID: 111fb672-9401-4913-a167-17b3d89a3e4f
94```
95 
96#### Prompt #3: Getting a View
97 
98```
99Show me the "Economy" view in the "Finances" project.
100```
101 
102#### Response
103 
104![Economy View Image](docs/static/img/economy-view.png)
105