MCP Excel Reader
A Model Context Protocol (MCP) server for reading Excel files with automatic chunking and pagination support. Built with SheetJS and TypeScript.
Overview
MCP Excel Reader is a Model Context Protocol (MCP) server designed for reading Excel files efficiently, featuring automatic chunking and pagination support. It is built using SheetJS and TypeScript, making it ideal for handling large datasets.
To use MCP Excel Reader, you can install it via Smithery or as an MCP server. After installation, you can read Excel files by invoking the read_excel tool with the required parameters such as file path and optional sheet name.
- 📊 Supports reading Excel files (.xlsx, .xls) with automatic size limits. - 🔄 Automatic chunking for large datasets to manage memory efficiently. - 📑 Allows sheet selection and row pagination for targeted data extraction. - 📅 Proper handling of date formats. - ⚡ Optimized for performance with large files. - 🛡️ Includes error handling and validation for robust operation.
- Efficiently reading large Excel files in data analysis applications.
- Extracting specific sheets or rows from complex Excel documents.
- Integrating with AI systems for automated data processing tasks.
Add to your AI client
Use these steps to connect MCP Excel Reader in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"excel-reader-mcp-archimedescrypto": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-excel-reader-mcp-archimedescrypto"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"excel-reader-mcp-archimedescrypto": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-excel-reader-mcp-archimedescrypto"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"excel-reader-mcp-archimedescrypto": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-excel-reader-mcp-archimedescrypto"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"excel-reader-mcp-archimedescrypto": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-excel-reader-mcp-archimedescrypto"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"excel-reader-mcp-archimedescrypto": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-excel-reader-mcp-archimedescrypto"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"excel-reader-mcp-archimedescrypto": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-excel-reader-mcp-archimedescrypto"
]
}
}
}FAQ
Can MCP Excel Reader handle very large Excel files?
Yes! It is designed to automatically chunk large files into manageable sizes for efficient processing.
Is there a limit to the number of sheets I can read?
No, you can read as many sheets as your Excel file contains, with the option to specify which one to read.
How do I install MCP Excel Reader?
You can install it via Smithery or by cloning the repository and following the installation instructions provided in the documentation.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1260,"uuid":"80761b2a-b789-48aa-b979-4dd1b2b7aa70","name":"excel-reader-mcp","title":"MCP Excel Reader","description":"A Model Context Protocol (MCP) server for reading Excel files with automatic chunking and pagination support. Built with SheetJS and TypeScript.","avatar_url":"https://avatars.githubusercontent.com/u/84040360?v=4","created_at":"2025-02-20T14:21:17.936Z","updated_at":"2025-02-23T07:21:18.313Z","status":"created","author_name":"ArchimedesCrypto","author_avatar_url":"https://avatars.githubusercontent.com/u/84040360?v=4","tags":"excel-reader,excel-files,data-processing","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/ArchimedesCrypto/excel-reader-mcp","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/b65c1a5353e44c104e555132eb2215ac07cd3bfef2c11492648f794aab499f8a/68747470733a2f2f736d6974686572792e61692f62616467652f4041726368696d6564657343727970746f2f657863656c2d7265616465722d6d63702d6368756e6b6564","type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]