Lets AI clients query Tableau data sources, explore workbooks and views, and retrieve analytics content from Tableau Cloud or Server.
Also known as tableau/tableau-mcp, @tableau/mcp-server
- Stars
- 373
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 14, 2026
- License
- Apache-2.0
What is Tableau MCP?
Tableau lets AI clients query Tableau data sources, explore workbooks and views, and retrieve analytics content from Tableau Cloud or Server.
Summary generated from the project's README
About Tableau MCP server
Querying Tableau data sources and exploring workbooks directly through AI clients is what this server enables for developers. It provides a suite of developer primitives, including tools, resources, and prompts, to help build applications that integrate with Tableau Cloud or Tableau Server. Users can retrieve analytics content, find specific views, or analyze data directly within their preferred AI interface.
For Tableau Cloud users, the hosted service at mcp.tableau.com offers a managed experience using OAuth 2.1, which ensures that existing per-user permissions are enforced automatically during the sign-in flow. Developers can also run the server locally using the @tableau/mcp-server npm package with Node.js 22.7.5 or later. Local setups for Tableau Server require configuration with a server URL, site name, and Personal Access Token details like PAT_NAME and PAT_VALUE.
This server is designed for web-based interaction and does not include the Tableau Desktop authoring server or its data. It can be deployed via Docker, Heroku, or as a Node.js Single Executable Application for environments without a Node.js installation.
What you can do with it
- 1Querying specific data sourcesAsk an AI client to identify top performing regions or metrics from a specific Tableau datasource.
- 2Exploring workbook metadataRequest information about which workbooks are most frequently accessed within your organization.
- 3Retrieving specific dashboard viewsInstruct an AI to locate and display a particular view within a designated project.
Written from the project's README. Every use case is checked against a quote from it.
How to install Tableau MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Tableau MCP in Claude Code
$ claude mcp add tableau-mcp -- npx -y @tableau/mcp-serverInstall Tableau MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"tableau-mcp": {
"command": "npx",
"args": [
"-y",
"@tableau/mcp-server"
]
}
}
}Install Tableau MCP in VS Code
.vscode/mcp.json
{
"servers": {
"tableau-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tableau/mcp-server"
]
}
}
}Install Tableau MCP in VS Code CLI
$ code --add-mcp '{"name":"tableau-mcp","type":"stdio","command":"npx","args":["-y","@tableau/mcp-server"]}'Install Tableau MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"tableau-mcp": {
"command": "npx",
"args": [
"-y",
"@tableau/mcp-server"
]
}
}
}Install Tableau MCP in Codex
$ codex mcp add tableau-mcp -- npx -y @tableau/mcp-serverInstall Tableau MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.tableau-mcp] command = "npx" args = ["-y", "@tableau/mcp-server"]
Install Tableau MCP in Gemini CLI
$ gemini mcp add -s user tableau-mcp npx -- -y @tableau/mcp-serverInstall Tableau MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"tableau-mcp": {
"command": "npx",
"args": [
"-y",
"@tableau/mcp-server"
]
}
}
}Needs a key before it starts
Started on 16 Nov 2026 with no keys, it stopped and asked for one, so a client sees no tools until you set the variables above.
Configuration
PAT_NAMEPAT_VALUESITE_NAME
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHubTableau MCP
Overview
Tableau MCP is a suite of developer primitives, including tools, resources and prompts, that will make it easier for developers to build AI applications that integrate with Tableau.
Official Documentation
https://tableau.github.io/tableau-mcp/
Getting Started
Hosted Tableau MCP (Recommended for Tableau Cloud)
Tableau 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.
Point any MCP-compatible client at https://mcp.tableau.com and complete the OAuth sign-in flow when prompted.
See Popular Client Integrations for step-by-step setup instructions for Slack, Claude, ChatGPT, and other common AI clients.
Tableau Server customers and Cloud customers who require self-hosted infrastructure should see the Enterprise Deployment and Self-Hosted Getting Started guides.
Self-Hosted / Local (npx)
The @tableau/mcp-server npm package contains the Web server for Tableau Cloud and Tableau
Server. It does not contain the Tableau Desktop authoring server or its data.
This is the quickest way to run Tableau MCP locally. It requires Node.js 22.7.5 or later — no cloning or building needed. Configure your AI tool (MCP client) with:
{
"mcpServers": {
"tableau": {
"command": "npx",
"args": ["-y", "@tableau/mcp-server@latest"],
"env": {
"SERVER": "https://my-tableau-server.com",
"SITE_NAME": "my_site",
"PAT_NAME": "my_pat",
"PAT_VALUE": "pat_value"
}
}
}
}
For Docker, building from source, and other self-hosted options, see the Getting Started guide.
Tableau Desktop Authoring Server
The npm package is Web-only. The Desktop authoring server is a separate build from this repo; see
docs/README.desktop.md for the quickstart.
Standalone Binaries (SEA)
The server can be packaged as a Node.js Single Executable Application
so it runs without a Node.js install. npm run build:sea -- --variant default builds the Web
executable into build/sea/default/<platform>/.
For a published GitHub Release, the upload-binaries workflow is configured to attach one archive
per supported release platform. Each archive contains the Web executable (tableau-mcp; .exe on
Windows) only. Releases that predate the archives may not have them.
Deploy to Heroku
Example Prompts to Client
Prompt #1: Querying Data
For the Superstore Datasource, what are the top 5 states with the most sales in 2025?
Response
Based on the Superstore Datasource, here are the top 5 states with the most sales in 2025:
1. California - $146,388.34
2. New York - $93,922.99
3. Washington - $65,539.90
4. Texas - $43,421.76
5. Pennsylvania - $42,688.31
California 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.
Prompt #2: Content Exploration
Find me the most viewed workbook within the last year.
Response
The most viewed workbook within the last year is:
Global Connections
- Owner: John Doe
- Project: Marketing
- Views in last year: 523
- Last Modified: September 2, 2025
- Workbook ID: 111fb672-9401-4913-a167-17b3d89a3e4f
Prompt #3: Getting a View
Show me the "Economy" view in the "Finances" project.
Response

Tableau MCP questions
How do I add Tableau MCP to Claude Code?
Run claude mcp add tableau-mcp -- npx -y @tableau/mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add Tableau MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does Tableau MCP respect existing Tableau permissions?
Yes. Each user signs in with their own Tableau Cloud identity, so existing per-user permissions are enforced automatically.
Can I run Tableau MCP locally?
Yes, using the @tableau/mcp-server npm package with Node.js 22.7.5 or later, configured with server, site, and PAT environment variables.
What can I ask Tableau MCP to do?
You can query datasources for metrics like top states by sales, find workbooks such as the most viewed one, and show specific views in a project.
Does the npm package support Tableau Desktop authoring?
No, the npm package is Web-only; the Desktop authoring server is a separate build from the repository.