test-tableau-mcp

@joeconstantino

About test-tableau-mcp

a quick POC to expose Tableau VDS endpoints through an MCP server and integrate them with Claude Desktop client

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "vds": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/test-tableau-mcp/",
        "run",
        "vds.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is test-tableau-mcp?

test-tableau-mcp is a prototype MCP server that exposes Tableau VDS endpoints as tools for Claude Desktop. It allows querying Tableau data sources via the VDS API using natural language.

How to use test-tableau-mcp?

Set up a Python environment with UV, hardcode four variables (server URL, metadata GraphQL URL, datasource LUID, and session token) in vds.py, then run the server with uv --directory <ABSOLUTE PATH> run vds.py. Configure Claude Desktop by adding the server to its claude_desktop_config.json and restart the app.

Key features of test-tableau-mcp

Exposes Tableau VDS API as MCP tools.
Query data sources with fields, filters, sorts, and limits.
Integrates directly with Claude Desktop.
Supports in-context sample payloads for correct syntax.
Requires manual authentication via hardcoded session token.

Use cases of test-tableau-mcp

Querying sales data by segment or region through Claude Desktop.
Filtering and sorting Tableau VDS measures with natural language.
Prototyping MCP-based access to Tableau virtual connections.
Demonstrating VDS API query formatting with in-context examples.

FAQ from test-tableau-mcp

What are the system requirements?

Python 3.10 or higher, MCP SDK 1.2.0 or higher, and UV installed.

How do I configure the required environment variables?

Hardcode four variables in vds.py: VIZQL_API_BASE, METADATA_GRAPHQL, DS_LUID, and AUTH_TOKEN.

How do I run the server?

Use uv --directory <ABSOLUTE PATH TO PROJECT> run vds.py.

How do I connect test-tableau-mcp to Claude Desktop?

Add a server entry with command uv, arguments ["--directory", "/ABSOLUTE/PATH/", "run", "vds.py"] in Claude Desktop's claude_desktop_config.json.

How do I query the VDS API through the server?

Start by passing in-context samples from samples.py to teach Claude the correct Query object syntax for fields, filters, sorts, and limits.

Frequently asked questions

What are the system requirements?

Python 3.10 or higher, MCP SDK 1.2.0 or higher, and UV installed.

How do I configure the required environment variables?

Hardcode four variables in vds.py: `VIZQL_API_BASE`, `METADATA_GRAPHQL`, `DS_LUID`, and `AUTH_TOKEN`.

How do I run the server?

Use `uv --directory <ABSOLUTE PATH TO PROJECT> run vds.py`.

How do I connect test-tableau-mcp to Claude Desktop?

Add a server entry with command `uv`, arguments `["--directory", "/ABSOLUTE/PATH/", "run", "vds.py"]` in Claude Desktop's `claude_desktop_config.json`.

How do I query the VDS API through the server?

Start by passing in-context samples from `samples.py` to teach Claude the correct `Query` object syntax for fields, filters, sorts, and limits.

Comments

Basic information

More Data & Analytics MCP servers

Subtext

Subtext by Fullstory

Session replay, built for agents. Subtext is agentic session review: it captures production sessions of your app and connects them to your coding agent — Claude Code, Cursor, Codex, Devin, your own harness — so it can

MCP Server for Data Exploration

reading-plus-ai

544

Bright Data MCP

luminati-io

A powerful Model Context Protocol (MCP) server that provides an all-in-one solution for public web access.

2.5K

Google Ads MCP

cohnen

An MCP tool that connects Google Ads with Claude AI/Cursor and others, allowing you to analyze your advertising data through natural language conversations. This integration gives you access to campaign information, performance metrics, keyword analytics, and ad management—all th

657

dbt MCP Server

dbt-labs

A MCP (Model Context Protocol) server for interacting with dbt.

587