A Model Context Protocol (MCP) server for Excel operations with enterprise-grade security and clean architecture. Seamlessly integrates with GitHub Copilot, Cline, and other MCP-compatible tools in VS Code.
Features
: Read, write, and manipulate Excel files (.xlsx, .xls)
Excel MCP Server: Connect AI agents to Excel/CSV files. Securely read, query, and analyze spreadsheet data for intelligent reporting.
Estrellas
4
Herramientas
—
Disponibilidad
—
Complete Excel Operations
Clean Architecture: Follows Single Responsibility Principle for maintainability
Enterprise Security: Robust permission system with path restrictions and access control
VS Code Integration: Works seamlessly with GitHub Copilot and Cline
TypeScript: Full type safety with modern ES2022+ features
Zero Deprecated Dependencies: Uses only current, actively maintained libraries
Quick Start
Installation
# Clone the repository
git clone https://github.com/az-coder-123/excel-mcp.git
cd excel-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Copy example environment file
cp .env.example .env
# Restrict access to specific directories
MCP_ALLOWED_PATHS=/home/user/documents,/workspace
# Block sensitive system directories
MCP_DENIED_PATHS=/etc/*,/sys/*,C:\Windows\*
# Set maximum file size (50MB default)
MCP_MAX_FILE_SIZE=52428800
VS Code Integration
This server works seamlessly with MCP-compatible tools in VS Code. See the dedicated setup guides for detailed configuration instructions:
Examples — Practical usage examples for all tool groups
Reference — Color codes, border styles, font names, AARRGGBB format
Security Features
Permission Levels
read: Read-only access to Excel files
write: Create and modify Excel files
delete: Delete worksheets and clear data
admin: Full administrative access
Path Restrictions
Configure allowed and denied paths using wildcards:
# Allow only specific directories
MCP_ALLOWED_PATHS=/workspace/*,/home/user/documents/*
# Block sensitive system paths
MCP_DENIED_PATHS=/etc/*,/sys/*,/proc/*,C:\Windows\*
File Size Limits
Prevent processing of excessively large files:
MCP_MAX_FILE_SIZE=52428800 # 50MB
Extension Whitelist
Only process specific file types (configured by default):
Single Responsibility: Each class/module has one clear purpose
Dependency Injection: Components are loosely coupled
Type Safety: Full TypeScript coverage with strict mode
Error Handling: Comprehensive error catching and reporting
Security First: Permission checks before all operations
Development
Scripts
# Development with hot reload
npm run dev
# Build for production
npm run build
# Run tests
npm test
# Lint code
npm run lint
# Format code
npm run format
# Clean build artifacts
npm run clean
Project Structure
src/ - TypeScript source files
dist/ - Compiled JavaScript output
docs/ - Documentation
package.json - Dependencies and scripts
tsconfig.json - TypeScript configuration
Environment Variables
Variable
Description
Default
MCP_SERVER_NAME
Server identifier
excel-mcp
MCP_SERVER_VERSION
Server version
1.0.0
MCP_LOG_LEVEL
Logging verbosity
info
MCP_ALLOWED_PATHS
Comma-separated allowed paths
All paths
MCP_DENIED_PATHS
Comma-separated denied paths
System paths
MCP_MAX_FILE_SIZE
Maximum file size in bytes
52428800 (50MB)
Troubleshooting
Common Issues
"Permission denied" errors
Check your MCP_ALLOWED_PATHS configuration
Ensure the file isn't in a denied path
Verify you have the required permission level
"Workbook not opened" errors
Call excel_open_workbook before other operations
Check that the file path is correct
Ensure the file isn't corrupted
TypeScript compilation errors
Run npm install to ensure all dependencies are installed
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Preguntas
¿Cómo instalo Excel?
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
¿Excel necesita una clave de API?
Este registro no indica ninguna variable de entorno obligatoria.
¿Qué transporte usa Excel?
Excel se ejecuta localmente por stdio.
¿Cuándo se comprobó Excel por última vez?
Última comprobación: 2026-11-05. Excel MCP Server: Connect AI agents to Excel/CSV files. Securely read, query, and analyze spreadsheet data for intelligent reporting.