Advertise
MCP.so
Sign In

Excel MCP Server

@bengbengbalabalabeng

Repository

Basic information

Category

Other

License

Apache-2.0

Transports

stdio

Author

bengbengbalabalabeng

Submitted by

蹦蹦巴拉巴拉蹦

About Excel MCP Server

Model Context Protocol (MCP) for Excel.

#excel#mcp#java#server

Excel MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "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>"
      }
    }
  }
}

Excel MCP Server tools

6

`excelPath` (string): Absolute or relative path to the Excel file.

`excelPath` (string): Absolute or relative path to the Excel file.

`excelPath` (string): Absolute or relative path to the Excel file.

`excelPath` (string): Absolute or relative path to the Excel file.

Clear all cached Excel file data from memory.

Test if the specified Excel file is available in cache.

Overview

What is Excel MCP Server?

Excel MCP Server is a Java implementation of the Model Context Protocol (MCP) for reading Excel files. It provides tools to extract headers, row data, sheet names, and row counts from XLSX, XLS, and CSV files while enforcing workspace‑based path validation. The server is intended for developers who want to enable AI assistants (e.g., Claude Desktop) to interact programmatically with spreadsheet data.

How to use Excel MCP Server?

Build the server with JDK 17+ GraalVM and Maven 3.9.6+ using mvn clean package -DskipTests=true. Then configure Claude Desktop by adding a server entry to claude_desktop_config.json, setting the command to java with the JAR path and the environment variable MCP_WORKSPACES (comma‑separated allowed directories). Optional cache settings can be tuned with CACHE_INITIAL_CAPACITY, CACHE_MAXIMUM_SIZE, and CACHE_EXPIRE_AFTER_WRITE. The server exposes tools such as get_total_rows_number, get_sheet_names, read_head_spec, read_rows_spec, and cache control tools.

Key features of Excel MCP Server

  • Read Excel files (XLSX, XLS, CSV) headers and data rows.
  • Validate input paths against configured workspace directories.
  • Support for multiple sheets and custom header‑row indices.
  • Retrieve total data row count excluding headers.
  • Built‑in performance caching for repeated file access.
  • Clear or test cache availability via dedicated tools.

Use cases of Excel MCP Server

  • Let an AI assistant read and summarize spreadsheet data.
  • Extract column headers and corresponding data rows for analysis.
  • Validate Excel file content against workspace permissions.
  • Efficiently reuse cached file data across multiple queries.

Frequently asked questions

1

Which file formats are supported?

XLSX, XLS, and CSV files are supported.

2

What are the runtime requirements?

JDK 17+ (GraalVM) and Maven 3.9.6+ are required to build and run the server.

3

How does workspace restriction work?

The server only allows operations on files located inside directories listed in the `MCP_WORKSPACES` environment variable (comma‑separated). Paths outside those directories are rejected.

4

Can I adjust caching behaviour?

Yes. Environment variables `CACHE_INITIAL_CAPACITY`, `CACHE_MAXIMUM_SIZE`, and `CACHE_EXPIRE_AFTER_WRITE` let you control the internal cache parameters. Defaults are 100, 1000, and 35 seconds respectively.

5

How is the server invoked (transport)?

The server communicates over standard I/O (stdio) as a subprocess of the MCP host (e.g., Claude Desktop). No authentication or network configuration is required.

Comments

More Other MCP servers

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K
P

PickFu MCP

PickFu MCP is a Model Context Protocol (MCP) server that connects AI assistants, developers, marketers, product managers, and AI agents to PickFu's consumer research platform. It enables users to create surveys, conduct

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Advertise