https://github.com/haris-musa/excel-mcp-server
A Model Context Protocol server for Excel file manipulation
https://github.com/haris-musa/excel-mcp-server
ai excel llm mcp mcp-server toolcalling
Last synced: 12 days ago
JSON representation
A Model Context Protocol server for Excel file manipulation
- Host: GitHub
- URL: https://github.com/haris-musa/excel-mcp-server
- Owner: haris-musa
- License: mit
- Created: 2025-02-12T06:39:48.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-04-04T08:29:03.000Z (13 days ago)
- Last Synced: 2025-04-04T08:30:59.330Z (13 days ago)
- Topics: ai, excel, llm, mcp, mcp-server, toolcalling
- Language: Python
- Homepage:
- Size: 43.9 KB
- Stars: 152
- Watchers: 4
- Forks: 16
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Excel - Spreadsheet creation and manipulation tools (👥 Community Contributions / Productivity & Knowledge Management)
- awesome-mcp-servers - Excel - Spreadsheet creation and manipulation tools (👥 Community Contributions / Productivity & Knowledge Management)
- awesome-mcp-zh - Excel (by haris-musa)
- awesome-mcp-list - @haris-musa/excel-mcp-server - musa/excel-mcp-server?style=social)](https://github.com/haris-musa/excel-mcp-server): Manipulates Excel workbooks, including data, formatting, and charts. (Uncategorized / Uncategorized)
- awesome-mcp-servers - @haris-musa/excel-mcp-server - An Excel manipulation server providing workbook creation, data operations, formatting, and advanced features (charts, pivot tables, formulae). (Legend / 💻 <a name="developer-tools"></a>Developer Tools)
- awesome-mcp-servers - @haris-musa/excel-mcp-server - An Excel manipulation server providing workbook creation, data operations, formatting, and advanced features (charts, pivot tables, formulae). (Legend / 💻 <a name="developer-tools"></a>Developer Tools)
- awesome-mcp-servers - Excel - Excel manipulation including data reading/writing, worksheet management, formatting, charts, and pivot table (Community Servers)
- Awesome-MCP-Servers-directory - Excel - Excel manipulation including data reading/writing, worksheet management, formatting, charts, and pivot table (Data Science Tools)
- awesome-mcp-servers - Excel - Excel workbook manipulation including data reading/writing, worksheet management, formatting, charts, and pivot tables (🗄️ <a name="databases"></a>Databases)
- awesome-mcp-servers - ExcelMCP - A Model Context Protocol server for Excel file manipulation (Table of Contents / Other Tools and Integrations)
- awesome-mcp-servers - ExcelMCP - A Model Context Protocol server for Excel file manipulation (Table of Contents / Other Tools and Integrations)
README
# Excel MCP Server
A Model Context Protocol (MCP) server implementation that provides Excel file manipulation capabilities without requiring Microsoft Excel installation. This server enables workbook creation, data manipulation, formatting, and advanced Excel features.
## Requirements
- Python 3.10+
- MCP SDK 1.2.0+
- OpenPyXL 3.1.2+
## Components
### Resources
The server provides Excel workbook manipulation through OpenPyXL:
- Creates and modifies Excel workbooks
- Manages worksheets and ranges
- Handles formatting and styles
- Supports charts and pivot tables
### Tools
This server provides a comprehensive set of Excel manipulation tools. For detailed documentation of all available tools, their parameters, and usage examples, please refer to [TOOLS.md](TOOLS.md).
The tools include capabilities for:
- Workbook and worksheet management
- Data reading and writing
- Formatting and styling
- Charts and visualizations
- Pivot tables and data analysis
See [TOOLS.md](TOOLS.md) for complete documentation.
## Features
- Full Excel Support: Comprehensive Excel functionality
- Data Manipulation: Read, write, and transform data
- Advanced Features: Charts, pivot tables, and formatting
- Error Handling: Comprehensive error handling with clear messages
## Usage
### Environment Configuration
The server can be configured using the following environment variables:
- `EXCEL_FILES_PATH`: Directory where Excel files will be stored (default: `./excel_files`)
You can set this in different ways:
Windows CMD:
```cmd
set EXCEL_FILES_PATH=C:\path\to\excel\files
uv run excel-mcp-server
```
Windows PowerShell:
```powershell
$env:EXCEL_FILES_PATH="C:\path\to\excel\files"
uv run excel-mcp-server
```
Linux/MacOS:
```bash
export EXCEL_FILES_PATH=/path/to/excel/files
uv run excel-mcp-server
```
Or in Claude Desktop config:
```json
{
"mcpServers": {
"excel": {
"command": "uv run excel-mcp-server",
"transport": "sse",
"env": {
"EXCEL_FILES_PATH": "/path/to/excel/files"
}
}
}
}
```
### Starting the Server
Start the server:
```bash
uv run excel-mcp-server
```
The server will start in SSE mode and wait for connections from MCP clients.
### Connecting in Cursor IDE
After starting the server, connect to the SSE endpoint in Cursor IDE:
```
http://localhost:8000/sse
```
The Excel MCP tools will be available through the agent.
For available tools and their usage, please refer to [TOOLS.md](TOOLS.md).
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.