Excel Mcp

Name: Excel Mcp
Author: choco9527

@choco9527

About Excel Mcp

> `excel-mcp` is a command-line service based on the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). It supports reading local Excel (`.xlsx`) and CSV (`.csv`) files, and integrates with interactive tools or AI assistants via the MCP protocol.

#excel-mcp #data-processing #command-line-tool

Basic information

Config

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

{
  "mcpServers": {
    "excel-mcp": {
      "command": "npx",
      "args": [
        "excel-mcp"
      ]
    }
  }
}

Tools

读取并理解一个 Excel 或 CSV 文件（包含表名/文件名、表头和前 10 行数据）

Overview

What is Excel Mcp?

Excel Mcp is a Model Context Protocol (MCP) server written in TypeScript that reads .xlsx Excel files. It parses all sheets, extracts headers, and returns the first 10 rows of data, enabling interactive tools to understand spreadsheet contents via the MCP protocol.

How to use Excel Mcp?

Install dependencies with npm install, build the project with npm run build, then start the server by running ./build/index.js. The server listens for requests over stdio. Alternatively, configure it in your MCP client using the npx command shown in the README.

Key features of Excel Mcp

Reads local .xlsx files
Parses all worksheets in a workbook
Extracts header row (first row) of each sheet
Displays the first 10 rows of data per sheet
Interactive calls through the MCP protocol

Use cases of Excel Mcp

Quickly preview the structure and content of an Excel file via an AI assistant
Automate extraction of spreadsheet headers and sample rows for data analysis
Integrate Excel data reading into MCP‑based workflows and tools

FAQ from Excel Mcp

What tool does Excel Mcp provide?

It provides a single tool read_excel that reads and understands an Excel file at a given path.

What parameters does the tool take?

The read_excel tool requires one parameter: filePath (string), the full path to a .xlsx file.

What information does the tool return?

It returns the names of all sheets, the header row for each sheet, and the first 10 rows of data from each sheet.

How is the MCP server launched?

The server runs via Node.js and listens on stdio. You can start it directly with ./build/index.js after building, or via npx excel-mcp in an MCP configuration.