Excel MCP Server

Java server implementing Model Context Protocol (MCP) for Excel operations with standardized header-to-column relationships.

Local serverstdio

What is the Excel MCP Server?

Excel MCP Server is an MCP project maintained in the bengbengbalabalabeng/fastexcel-mcp-server repository. The maintainer describes its purpose as “Java server implementing Model Context Protocol (MCP) for Excel operations with standardized header-to-column relationships”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using java. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares MCP_WORKSPACES, CACHE_INITIAL_CAPACITY, CACHE_MAXIMUM_SIZE, CACHE_EXPIRE_AFTER_WRITE. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

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
get_total_rows_numberwith cache support)
Inputs:excelPath (string): Absolute or relative path to the Excel file.
headRowNumberinteger): Row number (1-based index) where the header is located.
sheetNamestring, optional): Name of the sheet to read. Defaults to the first sheet if empty.
get_sheet_nameswith cache support)
read_head_specwith cache support)
read_rows_specwith cache support)
readRowNumbersinteger, optional): Number of data rows to read (excludes header). If null, reads all rows.
cache_clearClear all cached Excel file data from memory.
test_cache_availableTest if the specified Excel file is available in cache.
cachedboolean indicating if file is cached
resultstring containing file MD5 hash information

How to install the Excel MCP Server

{
  "mcpServers": {
    "fastexcel-mcp-server": {
      "command": "java",
      "args": [
        "-jar",
        "<YOUR_PATH>/fastexcel-mcp-server-0.0.1-SNAPSHOT.jar"
      ],
      "env": {
        "MCP_WORKSPACES": "<YOUR_MULTIPLE_WORKSPACES_SEPARATED_BY_COMMAS>",
        "CACHE_INITIAL_CAPACITY": "[OPTIONAL] <MINIMUM_TOTAL_SIZE_FOR_THE_INTERNAL_DATA_STRUCTURES> <DEFAULT: 100>",
        "CACHE_MAXIMUM_SIZE": "[OPTIONAL] <MAXIMUM_NUMBER_OF_ENTRIES_THE_CACHE_MAY_CONTAIN> <DEFAULT: 1000>",
        "CACHE_EXPIRE_AFTER_WRITE": "[OPTIONAL] <LENGTH_OF_TIME_AFTER_AN_ENTRY_IS_CREATED_THAT_IT_SHOULD_BE_AUTOMATICALLY_REMOVED> <DEFAULT: 35s>"
      }
    }
  }
}

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

Configuration

VariableDescriptionRequired
MCP_WORKSPACESDeclared in the maintainer’s client configuration.Check documentation
CACHE_INITIAL_CAPACITYDeclared in the maintainer’s client configuration.Optional
CACHE_MAXIMUM_SIZEDeclared in the maintainer’s client configuration.Optional
CACHE_EXPIRE_AFTER_WRITEDeclared in the maintainer’s client configuration.Optional