Summary
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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
55 tools
generate_layout_jsonGenerate and save a dashboard layout JSON file.3 params
Generate and save a dashboard layout JSON file.
Parameters* required
layout_treeobjectoutput_pathstringascii_previewstringinspect_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_sourcestringprofile_twb_for_migrationProfile workbook datasources and worksheet scope before migration.3 params
Profile workbook datasources and worksheet scope before migration.
Parameters* required
scopestringdefault: workbook
file_pathstringtarget_sourcestringdefault:
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
scopestringdefault: workbook
file_pathstringtarget_sourcestringmapping_overridesvaluepreview_twb_migrationPreview a workbook migration onto a target datasource.4 params
Preview a workbook migration onto a target datasource.
Parameters* required
scopestringdefault: workbook
file_pathstringtarget_sourcestringmapping_overridesvalueapply_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
scopestringdefault: workbook
file_pathstringoutput_pathstringtarget_sourcestringmapping_overridesvaluemigrate_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
scopestringdefault: workbook
file_pathstringoutput_pathstringdefault:
target_sourcestringmapping_overridesvalueapply_if_no_blockersbooleandefault: true
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
kindstringnamestringanalyze_twbAnalyze a TWB file against twilize's declared capabilities.1 params
Analyze a TWB file against twilize's declared capabilities.
Parameters* required
file_pathstringdiff_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_pathstringvalidate_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_pathvaluecreate_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_pathstringdefault:
workbook_namestringdefault:
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_pathstringlist_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
rolestringdefault:
formulastringdatatypestringdefault: real
field_namestringfield_typestringdefault:
default_formatstringdefault:
remove_calculated_fieldRemove a previously added calculated field.1 params
Remove a previously added calculated field.
Parameters* required
field_namestringadd_parameterAdd a parameter to the workbook.9 params
Add a parameter to the workbook.
Parameters* required
namestringdatatypestringdefault: real
max_valuestringdefault:
min_valuestringdefault:
domain_typestringdefault: range
granularitystringdefault:
default_valuestringdefault: 0
allowed_valuesvaluedefault_formatstringdefault:
add_worksheetAdd a new blank worksheet to the workbook.1 params
Add a new blank worksheet to the workbook.
Parameters* required
worksheet_namestringconfigure_chartConfigure chart type and field mappings for a worksheet.23 params
Configure chart type and field mappings for a worksheet.
Parameters* required
rowsvaluesizevaluecolorvaluelabelvaluedetailvaluecolumnsvaluefiltersvaluetooltipvaluecolor_mapvaluemark_typestringdefault: Automatic
label_runsvaluemap_fieldsvaluemap_layersvaluewedge_sizevaluelabel_paramvaluetext_formatvaluemeasure_valuesvalueworksheet_namestringmark_sizing_offbooleandefault: false
sort_descendingvalueaxis_fixed_rangevaluecustomized_labelvaluegeographic_fieldvalueconfigure_dual_axisConfigure a dual-axis chart composition.29 params
Configure a dual-axis chart composition.
Parameters* required
rowsvaluesize_1valuesize_2valuecolor_1valuecolor_2valuecolumnsvaluefiltersvaluelabel_1valuelabel_2valuedetail_1valuedetail_2valuehide_axesbooleandefault: false
color_map_1valuemark_type_1stringdefault: Bar
mark_type_2stringdefault: Line
show_labelsbooleandefault: true
mark_color_1valuemark_color_2valuesize_value_1valuesize_value_2valuesynchronizedbooleandefault: true
wedge_size_1valuewedge_size_2valuehide_zerolinebooleandefault: false
reverse_axis_1booleandefault: false
worksheet_namestringdual_axis_shelfstringdefault: rows
mark_sizing_offbooleandefault: false
sort_descendingvalueconfigure_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
hide_axesbooleandefault: false
axis_stylevaluecell_formatsvaluehide_bordersbooleandefault: false
hide_reflinesbooleandefault: false
hide_zerolinebooleandefault: false
label_formatsvalueheader_formatsvaluehide_droplinesbooleandefault: false
hide_gridlinesbooleandefault: false
worksheet_namestringdisable_tooltipbooleandefault: false
hide_band_colorbooleandefault: false
pane_cell_stylevaluepane_mark_stylevaluebackground_colorvaluehide_table_dividersbooleandefault: false
pane_datalabel_stylevaluehide_col_field_labelsbooleandefault: false
hide_row_field_labelsbooleandefault: false
pane_trendline_hiddenbooleandefault: false
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
recipe_argsvaluerecipe_namestringworksheet_namestringauto_ensure_prerequisitesbooleandefault: true
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
portstringdefault: 3306
dbnamestringserverstringusernamestringtable_namestringset_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
portstringdefault: 82
dbnamestringserverstringusernamestringdirectorystringdefault: /dataserver
table_namestringset_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
tablesvaluefilepathstringtable_namestringdefault: Extract
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
portstringdefault: 1433
dbnamestringusernamestringtable_namestringserver_hoststringadd_dashboardCreate a dashboard combining multiple worksheets.5 params
Create a dashboard combining multiple worksheets.
Parameters* required
widthintegerdefault: 1200
heightintegerdefault: 800
layoutvaluedefault: vertical
dashboard_namestringworksheet_namesarrayadd_dashboard_actionAdd an interaction action to a dashboard.7 params
Add an interaction action to a dashboard.
Parameters* required
fieldsarraycaptionstringdefault:
event_typestringdefault: on-select
action_typestringsource_sheetstringtarget_sheetstringdashboard_namestringadd_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
labelstringdefault:
scopestringdefault: per-pane
valuestringdefault:
formulastringdefault: constant
axis_fieldstringlabel_typestringdefault: automatic
line_colorstringdefault:
worksheet_namestringadd_reference_bandAdd a reference band (shaded region) to a worksheet.8 params
Add a reference band (shaded region) to a worksheet.
Parameters* required
scopestringdefault: per-pane
to_valuestringdefault:
axis_fieldstringfill_colorstringdefault: #E0E0E0
from_valuestringdefault:
to_formulastringdefault: constant
from_formulastringdefault: constant
worksheet_namestringadd_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
fitstringdefault: linear
degreeintegerdefault: 2
exclude_colorbooleandefault: false
worksheet_namestringshow_confidence_bandsbooleandefault: false
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
colorsvaluecustom_namestringdefault: twilize-palette
palette_namestringdefault:
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
font_familystringdefault:
dashboard_namestringtitle_font_sizestringdefault:
background_colorstringdefault:
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_pathstringinspect_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_pathstringencodingstringdefault: utf-8
sample_rowsintegerdefault: 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_pathstringmax_chartsintegerdefault: 0
rules_yamlstringdefault:
sample_rowsintegerdefault: 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_pathstringhyper_pathstringtable_namestringdefault: Extract
sample_rowsintegerdefault: 1000
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
themestringdefault:
csv_pathstringmax_chartsintegerdefault: 0
rules_yamlstringdefault:
output_pathstringdefault:
template_pathstringdefault:
dashboard_titlestringdefault:
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_pathstringtable_namestringdefault:
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
themestringdefault:
hyper_pathstringmax_chartsintegerdefault: 0
rules_yamlstringdefault:
table_namestringdefault:
output_pathstringdefault:
template_pathstringdefault:
dashboard_titlestringdefault:
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
portintegerdefault: 3306
themestringdefault:
dbnamestringpasswordstringdefault:
usernamestringmax_chartsintegerdefault: 0
rules_yamlstringdefault:
table_namestringoutput_pathstringdefault:
server_hoststringtemplate_pathstringdefault:
dashboard_titlestringdefault:
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
portintegerdefault: 1433
themestringdefault:
dbnamestringpasswordstringdefault:
usernamestringdefault:
max_chartsintegerdefault: 0
rules_yamlstringdefault:
table_namestringoutput_pathstringdefault:
server_hoststringtemplate_pathstringdefault:
dashboard_titlestringdefault:
trusted_connectionbooleandefault: false
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
keystringvaluestringsectionstringreset_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_pathstringdefault:
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_typestringdefault: 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_pathstringsample_rowsintegerdefault: 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
kpi_countvaluechart_typesvaluerecommend_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
csv_pathstringchart_typesvaluesample_rowsintegerdefault: 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.
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
PYTHONUNBUFFEREDdefault: 1Force unbuffered stdout so MCP stdio framing is never delayed by Python buffering.
PYTHONIOENCODINGdefault: utf-8Force UTF-8 stdio so non-ASCII content in workbooks survives the round trip.
MCP_LOG_LEVELdefault: infoServer log level. One of: debug, info, warning, error, critical.
OPENAI_API_KEYsecretOptional. Enables AI-assisted chart suggestions and reference-image styling.
Categories
Registryactive
Packagetwilize
TransportSTDIO, HTTP
AuthRequired
UpdatedMay 2, 2026
