Skip to content

tableau/tableau-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

266 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Tableau MCP

Tableau Supported

Build and Test

npm

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 quickest way to run Tableau MCP locally. 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.

Deploy to Heroku

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

Economy View Image

About

Tableau's official MCP Server. Helping agents see and understand data.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

304 stars

Watchers

10 watching

Forks

Packages

 
 
 

Contributors