# Twilize - Tableau Workbook Builder

Programmatic Tableau workbook (.twb/.twbx) generation. 47 MCP tools for charts, dashboards, calculated fields, workbook migration, and CSV-to-dashboard pipelines. Install via uvx twilize.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add suddh123/twilize

# Browse available tools
npx -y @smithery/cli@latest tool list suddh123/twilize

# Get full schema for a tool
npx -y @smithery/cli@latest tool get suddh123/twilize generate_layout_json

# Call a tool
npx -y @smithery/cli@latest tool call suddh123/twilize generate_layout_json '{}'
```

## Direct MCP Connection

Endpoint: `https://twilize--suddh123.run.tools`

## Tools (55)

- `generate_layout_json` — Generate and save a dashboard layout JSON file.
- `inspect_target_schema` — Inspect the first-sheet schema of a target Excel datasource.
- `profile_twb_for_migration` — Profile workbook datasources and worksheet scope before migration.
- `propose_field_mapping` — Scan source and target schema and propose a field mapping.
- `preview_twb_migration` — Preview a workbook migration onto a target datasource.
- `apply_twb_migration` — Apply a workbook migration and write a migrated TWB plus reports.
- `migrate_twb_guided` — Run the built-in migration workflow and pause for warning confirmation when needed.
- `list_capabilities` — List twilize's declared capability boundary.
- `describe_capability` — Describe one declared capability and its support tier.
- `analyze_twb` — Analyze a TWB file against twilize's declared capabilities.
- `diff_template_gap` — Summarize the non-core capability gap of a TWB template.
- `validate_workbook` — Run an informational XSD schema check on a workbook (2026.1 schema).
- `create_workbook` — Create a new workbook from a TWB or TWBX template file.
- `open_workbook` — Open an existing workbook (.twb or .twbx) for in-place worksheet editing.
- `list_fields` — List all available fields in the current workbook datasource.
- `list_worksheets` — List worksheet names in the current workbook.
- `list_dashboards` — List dashboards and their worksheet zones in the current workbook.
- `undo_last_change` — Undo the last mutating operation, restoring the previous workbook state.
- `add_calculated_field` — Add a calculated field to the datasource.
- `remove_calculated_field` — Remove a previously added calculated field.
- `add_parameter` — Add a parameter to the workbook.
- `add_worksheet` — Add a new blank worksheet to the workbook.
- `configure_chart` — Configure chart type and field mappings for a worksheet.
- `configure_dual_axis` — Configure a dual-axis chart composition.
- `configure_worksheet_style` — Apply worksheet-level styling: background color, axis/grid/border visibility.
- `configure_chart_recipe` — Configure a showcase recipe chart through the shared recipe registry.
- `set_mysql_connection` — Configure the workbook datasource to use a local MySQL connection.
- `set_tableauserver_connection` — Configure the workbook datasource to use a Tableau Server connection.
- `set_hyper_connection` — Configure the workbook datasource to use a local Hyper extract connection.
- `set_mssql_connection` — Configure the workbook datasource to use a Microsoft SQL Server connection.
- `add_dashboard` — Create a dashboard combining multiple worksheets.
- `add_dashboard_action` — Add an interaction action to a dashboard.
- `add_reference_line` — Add a reference line to a worksheet (constant, average, median, etc.).
- `add_reference_band` — Add a reference band (shaded region) to a worksheet.
- `add_trend_line` — Add a trend line to a worksheet (linear, polynomial, log, exp, power).
- `apply_color_palette` — Set a custom color palette. Built-in: tableau10, tableau20, blue-red, green-gold.
- `apply_dashboard_theme` — Apply uniform styling (background, font) to all zones in a dashboard.
- `save_workbook` — Save the workbook as a TWB file. Use a .twbx extension to produce a
- `inspect_csv` — Inspect a CSV file and return its inferred schema with column classification.
- `suggest_charts_for_csv` — Suggest chart types and configurations for a CSV file.
- `csv_to_hyper` — Convert a CSV file to a Tableau Hyper extract.
- `csv_to_dashboard` — Build a complete Tableau dashboard from a CSV file (end-to-end).
- `inspect_hyper` — Inspect a Hyper extract file and return its schema with column classification.
- `hyper_to_dashboard` — Build a complete Tableau dashboard from a Hyper extract file (end-to-end).
- `mysql_to_dashboard` — Build a Tableau dashboard from a MySQL table (end-to-end).
- `mssql_to_dashboard` — Build a Tableau dashboard from a Microsoft SQL Server table (end-to-end).
- `get_active_rules` — Return the active dashboard creation rules.
- `set_rule` — Set a specific rule value in the active dashboard rules.
- `reset_rules` — Reset all rules to the built-in defaults.
- `export_rules` — Export the current active rules to a YAML file.
- `profile_data_source` — Profile the currently connected data source.
- `profile_csv` — Profile a CSV file before connecting it.
- `recommend_template` — Score all gallery templates and recommend the best fit.
- `recommend_template_for_csv` — Recommend templates for a CSV file (no active workbook needed).
- `list_gallery_templates` — List all templates in the gallery with suitability rules.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get suddh123/twilize <tool-name>
```

## Resources

- `file://docs/tableau_all_functions.json` — Read the complete list of Tableau calculation functions.
- `twilize://skills/index` — List all available twilize agent skills.