Excel Mcp
@choco9527
> `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.
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
.xlsxfiles - 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.
Are there any authentication or transport options?
No. The README specifies only stdio transport and does not mention any authentication mechanism.
