Tableau Workbook Auditor — Claude Code MCP server: how to install
Parses Tableau workbooks locally to inspect dependencies, find duplicate logic, and surface unused fields. It compares versions without reading packaged data extracts.
claude mcp add tableau-lineage -- npx -y tableau-lineage-mcpWhat Tableau Workbook Auditor does
The server inspects .twb and .twbx files directly on your machine. When processing .twbx archives, it only extracts the XML layer. Packaged data files like .hyper and .tde remain untouched. No telemetry or external calls occur.
Its tools map dependencies across sheets, trace custom SQL queries, and inspect dashboard filters. You can run semantic diffs between two workbook files to identify modified calculations and broken downstream assets. Potential unused columns include confidence scores rather than absolute delete guarantees.
Running the package via stdio requires Node.js 18+. Tool parameters accept file paths directly, matching field names regardless of letter casing or surrounding brackets.
What it helps with
- Find unused calculated fields and parameters before cleanup
- Track calculation and filter differences between dashboard revisions
- Trace dependencies for complex calculated fields back to raw sources
- Extract embedded custom SQL statements and parameter definitions
Example prompts for the agent
- Audit ~/Downloads/Sales.twbx to see which fields can be removed.
- Compare the previous and current versions of Sales.twbx to find broken sheets.
- Trace all upstream fields and parameters needed for Profit Ratio.
How to install Tableau Workbook Auditor
Platform CLI
claude mcp add tableau-lineage -- npx -y tableau-lineage-mcpPlatform CLI
codex mcp add mcp -- npx -y tableau-lineage-mcpConfig file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"tableau-lineage-mcp"
]
}
}
}Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tableau-lineage-mcp"
]
}
}
}Platform CLI
gemini mcp add mcp npx -y tableau-lineage-mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Tableau Workbook Auditor
How to install Tableau Workbook Auditor in Claude Code?
Run claude mcp add tableau-lineage -- npx -y tableau-lineage-mcp in your terminal. Ensure your system has Node.js 18+ installed.
What does Tableau Workbook Auditor do?
It evaluates local Tableau workbooks to trace column dependencies, extract SQL queries, and flag duplicate formulas. The server also compares revisions semantically to highlight breaking edits.
Does the auditor read sensitive data extracts inside .twbx files?
No, it bypasses extract files entirely. The parser only decompresses workbook XML, leaving bundled .hyper or .tde data stores untouched.
