Twilize

subhatta123/twilize

You'd reach for this when you need to programmatically generate Tableau workbooks without opening Tableau Desktop. It exposes 47 tools that let you build charts, assemble dashboards, define calculation rules, and process CSV data into .twb or .twbx files. Think of it as a headless Tableau generator: you describe what you want through the MCP interface and get back a complete workbook file. Useful for automating report generation, templating dashboards from data pipelines, or creating Tableau artifacts as part of a larger workflow. Supports both local stdio and remote HTTP transport, so you can run it alongside Claude or call it from a web service.

tools: 55
auth: Secret needed
transport: STDIO, HTTP
env vars: 4
last updated: May 2, 2026

View on GitHub

Tools

55 tools

Public tool metadata for what this MCP can expose to an agent.

generate_layout_jsonGenerate and save a dashboard layout JSON file.3 params

Generate and save a dashboard layout JSON file.

Parameters* required

ascii_previewstring

layout_treeobject

output_pathstring

inspect_target_schemaInspect the first-sheet schema of a target Excel datasource.1 params

Inspect the first-sheet schema of a target Excel datasource.

Parameters* required

target_sourcestring

profile_twb_for_migrationProfile workbook datasources and worksheet scope before migration.3 params

Profile workbook datasources and worksheet scope before migration.

Parameters* required

file_pathstring

scopestring

default: workbook

target_sourcestring

default:

propose_field_mappingScan source and target schema and propose a field mapping.4 params

Scan source and target schema and propose a field mapping.

Parameters* required

file_pathstring

mapping_overridesvalue

scopestring

default: workbook

target_sourcestring

preview_twb_migrationPreview a workbook migration onto a target datasource.4 params

Preview a workbook migration onto a target datasource.

Parameters* required

file_pathstring

mapping_overridesvalue

scopestring

default: workbook

target_sourcestring

apply_twb_migrationApply a workbook migration and write a migrated TWB plus reports.5 params

Apply a workbook migration and write a migrated TWB plus reports.

Parameters* required

file_pathstring

mapping_overridesvalue

output_pathstring

scopestring

default: workbook

target_sourcestring

migrate_twb_guidedRun the built-in migration workflow and pause for warning confirmation when needed.6 params

Run the built-in migration workflow and pause for warning confirmation when needed.

Parameters* required

apply_if_no_blockersboolean

default: true

file_pathstring

mapping_overridesvalue

output_pathstring

default:

scopestring

default: workbook

target_sourcestring

list_capabilitiesList twilize's declared capability boundary.

List twilize's declared capability boundary.

No parameter schema in public metadata yet.

describe_capabilityDescribe one declared capability and its support tier.2 params

Describe one declared capability and its support tier.

Parameters* required

kindstring

namestring

analyze_twbAnalyze a TWB file against twilize's declared capabilities.1 params

Analyze a TWB file against twilize's declared capabilities.

Parameters* required

file_pathstring

diff_template_gapSummarize the non-core capability gap of a TWB template.1 params

Summarize the non-core capability gap of a TWB template.

Parameters* required

file_pathstring

validate_workbookRun an informational XSD schema check on a workbook (2026.1 schema). This is a non-blocking, advisory check only. Tableau Desktop is the true validator — it routinely produces workbooks that deviate from the published XSD schema, so deviations reported here do NOT indicate the...1 params

Run an informational XSD schema check on a workbook (2026.1 schema). This is a non-blocking, advisory check only. Tableau Desktop is the true validator — it routinely produces workbooks that deviate from the published XSD schema, so deviations reported here do NOT indicate the...

Parameters* required

file_pathvalue

create_workbookCreate a new workbook from a TWB or TWBX template file.2 params

Create a new workbook from a TWB or TWBX template file.

Parameters* required

template_pathstring

default:

workbook_namestring

default:

open_workbookOpen an existing workbook (.twb or .twbx) for in-place worksheet editing.1 params

Open an existing workbook (.twb or .twbx) for in-place worksheet editing.

Parameters* required

file_pathstring

list_fieldsList all available fields in the current workbook datasource.

List all available fields in the current workbook datasource.

No parameter schema in public metadata yet.

list_worksheetsList worksheet names in the current workbook.

List worksheet names in the current workbook.

No parameter schema in public metadata yet.

list_dashboardsList dashboards and their worksheet zones in the current workbook.

List dashboards and their worksheet zones in the current workbook.

No parameter schema in public metadata yet.

undo_last_changeUndo the last mutating operation, restoring the previous workbook state.

Undo the last mutating operation, restoring the previous workbook state.

No parameter schema in public metadata yet.

add_calculated_fieldAdd a calculated field to the datasource.6 params

Add a calculated field to the datasource.

Parameters* required

datatypestring

default: real

default_formatstring

default:

field_namestring

field_typestring

default:

formulastring

rolestring

default:

remove_calculated_fieldRemove a previously added calculated field.1 params

Remove a previously added calculated field.

Parameters* required

field_namestring

add_parameterAdd a parameter to the workbook.9 params

Add a parameter to the workbook.

Parameters* required

allowed_valuesvalue

datatypestring

default: real

default_formatstring

default:

default_valuestring

default: 0

domain_typestring

default: range

granularitystring

default:

max_valuestring

default:

min_valuestring

default:

namestring

add_worksheetAdd a new blank worksheet to the workbook.1 params

Add a new blank worksheet to the workbook.

Parameters* required

worksheet_namestring

configure_chartConfigure chart type and field mappings for a worksheet.23 params

Configure chart type and field mappings for a worksheet.

Parameters* required

axis_fixed_rangevalue

colorvalue

color_mapvalue

columnsvalue

customized_labelvalue

detailvalue

filtersvalue

geographic_fieldvalue

labelvalue

label_paramvalue

label_runsvalue

map_fieldsvalue

map_layersvalue

mark_sizing_offboolean

default: false

mark_typestring

default: Automatic

measure_valuesvalue

rowsvalue

sizevalue

sort_descendingvalue

text_formatvalue

+3 more parameters. See the server's own documentation for the full schema.

configure_dual_axisConfigure a dual-axis chart composition.29 params

Configure a dual-axis chart composition.

Parameters* required

color_1value

color_2value

color_map_1value

columnsvalue

detail_1value

detail_2value

dual_axis_shelfstring

default: rows

filtersvalue

hide_axesboolean

default: false

hide_zerolineboolean

default: false

label_1value

label_2value

mark_color_1value

mark_color_2value

mark_sizing_offboolean

default: false

mark_type_1string

default: Bar

mark_type_2string

default: Line

reverse_axis_1boolean

default: false

rowsvalue

show_labelsboolean

default: true

+9 more parameters. See the server's own documentation for the full schema.

configure_worksheet_styleApply worksheet-level styling: background color, axis/grid/border visibility.21 params

Apply worksheet-level styling: background color, axis/grid/border visibility.

Parameters* required

axis_stylevalue

background_colorvalue

cell_formatsvalue

disable_tooltipboolean

default: false

header_formatsvalue

hide_axesboolean

default: false

hide_band_colorboolean

default: false

hide_bordersboolean

default: false

hide_col_field_labelsboolean

default: false

hide_droplinesboolean

default: false

hide_gridlinesboolean

default: false

hide_reflinesboolean

default: false

hide_row_field_labelsboolean

default: false

hide_table_dividersboolean

default: false

hide_zerolineboolean

default: false

label_formatsvalue

pane_cell_stylevalue

pane_datalabel_stylevalue

pane_mark_stylevalue

pane_trendline_hiddenboolean

default: false

+1 more parameters. See the server's own documentation for the full schema.

configure_chart_recipeConfigure a showcase recipe chart through the shared recipe registry.4 params

Configure a showcase recipe chart through the shared recipe registry.

Parameters* required

auto_ensure_prerequisitesboolean

default: true

recipe_argsvalue

recipe_namestring

worksheet_namestring

set_mysql_connectionConfigure the workbook datasource to use a local MySQL connection.5 params

Configure the workbook datasource to use a local MySQL connection.

Parameters* required

dbnamestring

portstring

default: 3306

serverstring

table_namestring

usernamestring

set_tableauserver_connectionConfigure the workbook datasource to use a Tableau Server connection.6 params

Configure the workbook datasource to use a Tableau Server connection.

Parameters* required

dbnamestring

directorystring

default: /dataserver

portstring

default: 82

serverstring

table_namestring

usernamestring

set_hyper_connectionConfigure the workbook datasource to use a local Hyper extract connection.3 params

Configure the workbook datasource to use a local Hyper extract connection.

Parameters* required

filepathstring

table_namestring

default: Extract

tablesvalue

set_mssql_connectionConfigure the workbook datasource to use a Microsoft SQL Server connection.5 params

Configure the workbook datasource to use a Microsoft SQL Server connection.

Parameters* required

dbnamestring

portstring

default: 1433

server_hoststring

table_namestring

usernamestring

add_dashboardCreate a dashboard combining multiple worksheets.5 params

Create a dashboard combining multiple worksheets.

Parameters* required

dashboard_namestring

heightinteger

default: 800

layoutvalue

default: vertical

widthinteger

default: 1200

worksheet_namesarray

add_dashboard_actionAdd an interaction action to a dashboard.7 params

Add an interaction action to a dashboard.

Parameters* required

action_typestring

captionstring

default:

dashboard_namestring

event_typestring

default: on-select

fieldsarray

source_sheetstring

target_sheetstring

add_reference_lineAdd a reference line to a worksheet (constant, average, median, etc.).8 params

Add a reference line to a worksheet (constant, average, median, etc.).

Parameters* required

axis_fieldstring

formulastring

default: constant

labelstring

default:

label_typestring

default: automatic

line_colorstring

default:

scopestring

default: per-pane

valuestring

default:

worksheet_namestring

add_reference_bandAdd a reference band (shaded region) to a worksheet.8 params

Add a reference band (shaded region) to a worksheet.

Parameters* required

axis_fieldstring

fill_colorstring

default: #E0E0E0

from_formulastring

default: constant

from_valuestring

default:

scopestring

default: per-pane

to_formulastring

default: constant

to_valuestring

default:

worksheet_namestring

add_trend_lineAdd a trend line to a worksheet (linear, polynomial, log, exp, power).5 params

Add a trend line to a worksheet (linear, polynomial, log, exp, power).

Parameters* required

degreeinteger

default: 2

exclude_colorboolean

default: false

fitstring

default: linear

show_confidence_bandsboolean

default: false

worksheet_namestring

apply_color_paletteSet a custom color palette. Built-in: tableau10, tableau20, blue-red, green-gold.3 params

Set a custom color palette. Built-in: tableau10, tableau20, blue-red, green-gold.

Parameters* required

colorsvalue

custom_namestring

default: twilize-palette

palette_namestring

default:

apply_dashboard_themeApply uniform styling (background, font) to all zones in a dashboard.4 params

Apply uniform styling (background, font) to all zones in a dashboard.

Parameters* required

background_colorstring

default:

dashboard_namestring

font_familystring

default:

title_font_sizestring

default:

save_workbookSave the workbook as a TWB file. Use a .twbx extension to produce a packaged workbook (ZIP) that bundles the XML with any data extracts and images carried over from the source .twbx.1 params

Save the workbook as a TWB file. Use a .twbx extension to produce a packaged workbook (ZIP) that bundles the XML with any data extracts and images carried over from the source .twbx.

Parameters* required

output_pathstring

inspect_csvInspect a CSV file and return its inferred schema with column classification. Reads the CSV, infers column types (integer, float, date, boolean, string), classifies columns as dimensions or measures with semantic types (categorical, temporal, geographic, numeric), and returns...3 params

Inspect a CSV file and return its inferred schema with column classification. Reads the CSV, infers column types (integer, float, date, boolean, string), classifies columns as dimensions or measures with semantic types (categorical, temporal, geographic, numeric), and returns...

Parameters* required

csv_pathstring

encodingstring

default: utf-8

sample_rowsinteger

default: 1000

suggest_charts_for_csvSuggest chart types and configurations for a CSV file. Analyzes the data shape (dimensions, measures, temporal fields, etc.) and returns prioritized chart suggestions with shelf assignments. Args: csv_path: Path to the CSV file. max_charts: Maximum number of charts to suggest...4 params

Suggest chart types and configurations for a CSV file. Analyzes the data shape (dimensions, measures, temporal fields, etc.) and returns prioritized chart suggestions with shelf assignments. Args: csv_path: Path to the CSV file. max_charts: Maximum number of charts to suggest...

Parameters* required

csv_pathstring

max_chartsinteger

default: 0

rules_yamlstring

default:

sample_rowsinteger

default: 1000

csv_to_hyperConvert a CSV file to a Tableau Hyper extract. Infers column types and creates a .hyper file that can be used as a data source in Tableau workbooks. Requires tableauhyperapi (pip install tableauhyperapi). Args: csv_path: Path to the source CSV file. hyper_path: Output path for...4 params

Convert a CSV file to a Tableau Hyper extract. Infers column types and creates a .hyper file that can be used as a data source in Tableau workbooks. Requires tableauhyperapi (pip install tableauhyperapi). Args: csv_path: Path to the source CSV file. hyper_path: Output path for...

Parameters* required

csv_pathstring

hyper_pathstring

sample_rowsinteger

default: 1000

table_namestring

default: Extract

csv_to_dashboardBuild a complete Tableau dashboard from a CSV file (end-to-end). Pipeline: CSV → schema inference → chart suggestion → Hyper extract → workbook creation → chart configuration → dashboard layout → .twbx output. Args: csv_path: Path to the source CSV file. output_path: Output .t...7 params

Build a complete Tableau dashboard from a CSV file (end-to-end). Pipeline: CSV → schema inference → chart suggestion → Hyper extract → workbook creation → chart configuration → dashboard layout → .twbx output. Args: csv_path: Path to the source CSV file. output_path: Output .t...

Parameters* required

csv_pathstring

dashboard_titlestring

default:

max_chartsinteger

default: 0

output_pathstring

default:

rules_yamlstring

default:

template_pathstring

default:

themestring

default:

inspect_hyperInspect a Hyper extract file and return its schema with column classification. Reads the Hyper file, maps column types, classifies columns as dimensions or measures, and returns a summary. Requires tableauhyperapi (pip install tableauhyperapi). Args: hyper_path: Path to the .h...2 params

Inspect a Hyper extract file and return its schema with column classification. Reads the Hyper file, maps column types, classifies columns as dimensions or measures, and returns a summary. Requires tableauhyperapi (pip install tableauhyperapi). Args: hyper_path: Path to the .h...

Parameters* required

hyper_pathstring

table_namestring

default:

hyper_to_dashboardBuild a complete Tableau dashboard from a Hyper extract file (end-to-end). Pipeline: Hyper → schema inference → chart suggestion → workbook creation → chart configuration → dashboard layout → .twbx output. Args: hyper_path: Path to the .hyper file. output_path: Output .twbx pa...8 params

Build a complete Tableau dashboard from a Hyper extract file (end-to-end). Pipeline: Hyper → schema inference → chart suggestion → workbook creation → chart configuration → dashboard layout → .twbx output. Args: hyper_path: Path to the .hyper file. output_path: Output .twbx pa...

Parameters* required

dashboard_titlestring

default:

hyper_pathstring

max_chartsinteger

default: 0

output_pathstring

default:

rules_yamlstring

default:

table_namestring

default:

template_pathstring

default:

themestring

default:

mysql_to_dashboardBuild a Tableau dashboard from a MySQL table (end-to-end). Pipeline: MySQL → schema inference → chart suggestion → workbook creation → live MySQL connection → .twb output. Requires mysql-connector-python for schema inference. Args: server_host: MySQL server hostname. dbname: D...12 params

Build a Tableau dashboard from a MySQL table (end-to-end). Pipeline: MySQL → schema inference → chart suggestion → workbook creation → live MySQL connection → .twb output. Requires mysql-connector-python for schema inference. Args: server_host: MySQL server hostname. dbname: D...

Parameters* required

dashboard_titlestring

default:

dbnamestring

max_chartsinteger

default: 0

output_pathstring

default:

passwordstring

default:

portinteger

default: 3306

rules_yamlstring

default:

server_hoststring

table_namestring

template_pathstring

default:

themestring

default:

usernamestring

mssql_to_dashboardBuild a Tableau dashboard from a Microsoft SQL Server table (end-to-end). Pipeline: MSSQL → schema inference → chart suggestion → workbook creation → live MSSQL connection → .twb output. Requires pyodbc for schema inference and ODBC Driver 17 for SQL Server. Args: server_host:...13 params

Build a Tableau dashboard from a Microsoft SQL Server table (end-to-end). Pipeline: MSSQL → schema inference → chart suggestion → workbook creation → live MSSQL connection → .twb output. Requires pyodbc for schema inference and ODBC Driver 17 for SQL Server. Args: server_host:...

Parameters* required

dashboard_titlestring

default:

dbnamestring

max_chartsinteger

default: 0

output_pathstring

default:

passwordstring

default:

portinteger

default: 1433

rules_yamlstring

default:

server_hoststring

table_namestring

template_pathstring

default:

themestring

default:

trusted_connectionboolean

default: false

usernamestring

default:

get_active_rulesReturn the active dashboard creation rules. Call this at the start of a session to understand what constraints are enforced. The rules engine validates every configure_chart and add_dashboard call — violations are returned as errors or warnings. Returns: Human-readable summary...

Return the active dashboard creation rules. Call this at the start of a session to understand what constraints are enforced. The rules engine validates every configure_chart and add_dashboard call — violations are returned as errors or warnings. Returns: Human-readable summary...

No parameter schema in public metadata yet.

set_ruleSet a specific rule value in the active dashboard rules. This allows admins to modify rules at runtime without editing YAML files. Changes persist for the current session and can be exported with export_rules(). Args: section: Rule section name. Options: "kpi" — KPI formatting...3 params

Set a specific rule value in the active dashboard rules. This allows admins to modify rules at runtime without editing YAML files. Changes persist for the current session and can be exported with export_rules(). Args: section: Rule section name. Options: "kpi" — KPI formatting...

Parameters* required

keystring

sectionstring

valuestring

reset_rulesReset all rules to the built-in defaults. Discards any runtime changes made via set_rule() and reloads the default rules from the package YAML file. Returns: Confirmation message.

Reset all rules to the built-in defaults. Discards any runtime changes made via set_rule() and reloads the default rules from the package YAML file. Returns: Confirmation message.

No parameter schema in public metadata yet.

export_rulesExport the current active rules to a YAML file. Saves the complete rules (including any runtime changes from set_rule()) to a YAML file that can be placed next to data files or in the working directory for future sessions. Args: output_path: Path to save the YAML file. Default...1 params

Export the current active rules to a YAML file. Saves the complete rules (including any runtime changes from set_rule()) to a YAML file that can be placed next to data files or in the working directory for future sessions. Args: output_path: Path to save the YAML file. Default...

Parameters* required

output_pathstring

default:

profile_data_sourceProfile the currently connected data source. Works for ANY connection type: CSV extract, Hyper, MySQL, Tableau Server, Excel — anything that has fields in the workbook. The profile includes dimension/measure classification, semantic types, domain hints, and boolean signals tha...1 params

Profile the currently connected data source. Works for ANY connection type: CSV extract, Hyper, MySQL, Tableau Server, Excel — anything that has fields in the workbook. The profile includes dimension/measure classification, semantic types, domain hints, and boolean signals tha...

Parameters* required

source_typestring

default: auto

profile_csvProfile a CSV file before connecting it. Unlike profile_data_source (which needs an active workbook), this tool profiles a raw CSV file directly. Args: csv_path: Path to the CSV file. sample_rows: Number of rows to sample for type inference. Returns: Human-readable DataProfile.2 params

Profile a CSV file before connecting it. Unlike profile_data_source (which needs an active workbook), this tool profiles a raw CSV file directly. Args: csv_path: Path to the CSV file. sample_rows: Number of rows to sample for type inference. Returns: Human-readable DataProfile.

Parameters* required

csv_pathstring

sample_rowsinteger

default: 1000

recommend_templateScore all gallery templates and recommend the best fit. Call this AFTER profiling the data source and deciding on chart types, but BEFORE creating the dashboard layout. The decider evaluates every template in the gallery against the data profile and chart mix, returning a rank...2 params

Score all gallery templates and recommend the best fit. Call this AFTER profiling the data source and deciding on chart types, but BEFORE creating the dashboard layout. The decider evaluates every template in the gallery against the data profile and chart mix, returning a rank...

Parameters* required

chart_typesvalue

kpi_countvalue

recommend_template_for_csvRecommend templates for a CSV file (no active workbook needed). Args: csv_path: Path to the CSV file. chart_types: Comma-separated chart types (optional). sample_rows: Rows to sample for inference. Returns: Ranked template recommendations.3 params

Recommend templates for a CSV file (no active workbook needed). Args: csv_path: Path to the CSV file. chart_types: Comma-separated chart types (optional). sample_rows: Rows to sample for inference. Returns: Ranked template recommendations.

Parameters* required

chart_typesvalue

csv_pathstring

sample_rowsinteger

default: 1000

list_gallery_templatesList all templates in the gallery with suitability rules. Templates are user-editable YAML files in ``templates/gallery/``. Each template defines layout zones, suitability criteria, recommended themes, and auto-wired interaction actions. Returns: Formatted listing of all galle...

List all templates in the gallery with suitability rules. Templates are user-editable YAML files in ``templates/gallery/``. Each template defines layout zones, suitability criteria, recommended themes, and auto-wired interaction actions. Returns: Formatted listing of all galle...

No parameter schema in public metadata yet.

Configuration

PYTHONUNBUFFEREDdefault: 1

Force unbuffered stdout so MCP stdio framing is never delayed by Python buffering.

PYTHONIOENCODINGdefault: utf-8

Force UTF-8 stdio so non-ASCII content in workbooks survives the round trip.

MCP_LOG_LEVELdefault: info

Server log level. One of: debug, info, warning, error, critical.

OPENAI_API_KEYsecret

Optional. Enables AI-assisted chart suggestions and reference-image styling.

Readme

Details

Repository: github.com/subhatta123/twilize
Website: github.com/subhatta123/twilize
Category: Data & Analytics
Package: twilize
Transport: STDIO, HTTP
Auth: Required
Registry: MCP registry, active

Related Data & Analytics MCP servers

View all

Sivut SEC Crypto Filing Radarrambov1/sivut-x402-public-dataSEC EDGAR crypto filing radar MCP with x402-paid Base USDC data URLs.0stars

Metabasemetabase/metabaseLets AI clients search, explore, query, and visualize data in a Metabase instance.47.6Kstars

Grafanagrafana/mcp-grafanaAn MCP server giving access to Grafana dashboards, data and more.3.7Kstars

Xiaohongshuaki66938/xhs-toolkitProvides MCP-based access to Xiaohongshu login, publishing, data collection and AI-driven analysis1.3Kstars

Google Adscohnen/mcp-google-adsAn MCP tool that connects Google Ads with Claude AI/Cursor and others, allowing you to analyze your advertising data through natural language conversations. Thi609stars

Apple Healthneiltron/apple-health-mcpLocal-first Apple Health MCP server for questions about your sleep, workouts and heart data.575stars