Skip to main content
Glama
Tableau MCP Server

Tableau MCP Server

Tableau MCP Server

A Model Context Protocol (MCP) server for Tableau Server and Tableau Cloud, built on the official mcp Python SDK (FastMCP). It authenticates via a Personal Access Token (PAT) and exposes read/write tools backed by the Tableau REST API.

Features

  • PAT-based sign-in with automatic sign-out on shutdown (via FastMCP lifespan)

  • Async httpx client with typed exceptions (TableauError, AuthenticationError, APIError, NotFoundError)

  • Tools for sites, projects, workbooks, views, data sources

  • View data (CSV) and image (PNG) retrieval

  • Extract refresh and workbook download helpers

Related MCP server: Tableau MCP Server

Installation

git clone https://github.com/asklokesh/tableau-mcp-server.git
cd tableau-mcp-server
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Configuration

All settings are read from environment variables with the TABLEAU_ prefix (a .env file next to the working directory is also supported).

Variable

Default

Description

TABLEAU_SERVER_URL

(required)

Base URL, e.g. https://10ax.online.tableau.com or https://tableau.example.com

TABLEAU_API_VERSION

3.22

Tableau REST API version

TABLEAU_SITE_CONTENT_URL

""

Site content URL; empty string targets the default site

TABLEAU_PAT_NAME

(required)

Personal Access Token name

TABLEAU_PAT_SECRET

(required)

Personal Access Token secret

TABLEAU_TIMEOUT

60

HTTP request timeout (seconds)

Running

tableau-mcp
# or
python -m tableau_mcp.server

Claude Desktop configuration

{
  "mcpServers": {
    "tableau": {
      "command": "tableau-mcp",
      "env": {
        "TABLEAU_SERVER_URL": "https://10ax.online.tableau.com",
        "TABLEAU_SITE_CONTENT_URL": "mysite",
        "TABLEAU_PAT_NAME": "my-pat",
        "TABLEAU_PAT_SECRET": "xxxxxxxxxxxx"
      }
    }
  }
}

Tools

Tool

Description

list_sites

List all sites reachable with the current PAT

list_projects

List projects on a site

list_workbooks

List workbooks, optionally filtered by project name

list_views

List views on a site or for a specific workbook

list_datasources

List published data sources

query_view_data

Return view data as CSV (optional vf_* filters)

query_view_image

Return view rendering as a base64-encoded PNG

refresh_datasource

Trigger an extract refresh for a data source

refresh_workbook

Trigger an extract refresh for a workbook

download_workbook

Download a workbook as base64-encoded .twb/.twbx

Development

pip install -e ".[dev]"
pytest -x --tb=short
ruff check src tests

License

MIT License - see LICENSE file for details.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI applications to integrate with Tableau through developer primitives including tools, resources and prompts. Supports querying data from datasources, exploring content like workbooks and views, and retrieving visualizations using the Tableau REST API.
      33,264 npm
      Apache 2.0
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables discovery, querying, and exporting of Tableau Cloud dashboards and data sources. Supports searching workbooks, filtering data, and exporting views as PDF, PNG, PowerPoint, CSV, or JSON.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables integration with Tableau to query data, explore workbook content, and retrieve visualization images through natural language. It provides developer primitives for building AI applications that interact seamlessly with Tableau servers.
      33,264 npm
      Apache 2.0