Sheetforge MCP Server

SheetForge MCP is an Excel MCP server for `.xlsx` automation over the Model Context Protocol. It is built for AI agents, MCP clients, and automation

Local serverstdioPython

What is the Sheetforge MCP Server?

SheetForge MCP is an Excel MCP server for .xlsx automation over the Model Context Protocol. It is built for AI agents, MCP clients, and automation workflows that

What the server does

  • agent-friendly reads via suggest_read_strategy, describe_dataset, query_table, and aggregate_table
  • safer workbook creation: create_workbook now refuses to overwrite an existing .xlsx
  • smarter worksheet boundaries so compact readers stop at the main contiguous data block and surface trailing-row hints instead of over-reading sparse footer noise
  • workbook and layout awareness via profile_workbook, describe_sheet_layout, list_tables, list_charts, and analyze_range_impact
  • safer local mutation through dry_run, compact write responses, guarded native-table append/upsert flows, and workbook diff/audit/repair loops
  • local-first performance and privacy with openpyxl, no desktop Excel dependency, and no cloud-auth requirement

Credentials and setup notes

  • Python 3.10+ - .xlsx workbooks - either uvx or a local package install

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
agentfriendly reads via suggest_read_strategy, describe_dataset, query_table, and aggregate_table
localfirst performance and privacy with openpyxl, no desktop Excel dependency, and no cloud-auth requirement
suggest_read_strategyrecommends the best next read tool for a workbook target, including whether SheetForge should treat it as a native Excel table, a clean worksheet dataset, a layout-heavy dashboard sheet, or a chart sheet
describe_datasetsamples a worksheet or native Excel table and returns headers, schema hints, key-candidate guesses, structural signals, and a recommended follow-up read path
query_tablefilters, projects, sorts, and limits worksheet-shaped data or native Excel tables with a declarative JSON query instead of ad hoc cell loops
aggregate_tablecomputes grouped metrics such as count, sum, avg, min, and max over worksheet-shaped data or native Excel tables
bulk_aggregate_workbookscomputes the same grouped metrics across many workbook files in one call, with explicit schema handling via strict, intersect, or union
bulk_filter_workbooksreturns matching rows across many workbook files with optional source provenance columns, so recurring cross-file QA and reporting checks no longer need one-tool-call-per-file loops
union_tablescombines comparable worksheet or native-table rows across many workbook files, with optional deduplication keys and explicit schema handling for workbook collections that drift over time
cross_workbook_lookupenriches one workbook dataset from one or more lookup workbooks with left-join style matching, optional duplicate-match handling, and compact per-row provenance for matched lookup rows
profile_workbookone-call inventory for sheets, tables, charts, named ranges, and key layout/protection state, including chart occupied_range for grid-anchored worksheet charts
describe_sheet_layoutworksheet-level structural summary for safe dashboard edits, including freeze panes, print settings, merges, chart anchors, table metadata, conditional-format and validation counts, custom row/column sizing, and a small
audit_workbookworkbook-level audit for high-signal problems such as broken #REF! formulas, error cells, hidden sheets, header-quality issues, layout-heavy sheets, and named ranges that reference missing sheets
plan_workbook_repairsconverts workbook audit findings into prioritized next steps, including suggested SheetForge tool calls for inspection, safe dry runs, and repair workflows

How to install the Sheetforge MCP Server

{
  "mcpServers": {
    "excel": {
      "command": "uvx",
      "args": [
        "sheetforge-mcp",
        "stdio"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.10+ - .xlsx workbooks - either uvx or a local package install

Example prompts to try

  • “Use Sheetforge MCP to agent.”
  • “Use Sheetforge MCP to local.”
  • “Use Sheetforge MCP to suggest read strategy.”

Frequently asked questions

SheetForge MCP is an Excel MCP server for `.xlsx` automation over the Model Context Protocol. It is built for AI agents, MCP clients, and automation workflows that Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.