- Home
- MCP servers
- Excel
Excel
- python
81
GitHub Stars
python
Language
6 months ago
First Indexed
2 months ago
Catalog Refreshed
Documentation & install
Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.
Installation
Add the following to your MCP client configuration file.
Configuration
View docs{
"mcpServers": {
"yzfly-mcp-excel-server": {
"command": "uvx",
"args": [
"mcp-excel-server"
],
"env": {
"PYTHONPATH": " /path/to/your/python"
}
}
}
}You can run and use an MCP server that specializes in Excel file management, data analysis, and visualization. It lets you read and write Excel-like data, analyze it with statistics, create pivot tables, and generate charts, all accessible through your MCP client. This guide shows you how to set up, run, and connect to the server so you can perform practical data workflows from your applications or tools.
How to use
You interact with the Excel MCP Server through an MCP client. Start the local server, then connect your client to run operations such as reading Excel files, obtaining file information, performing data analysis, creating pivot tables, and exporting charts. Use the client’s prompts or built-in templates to guide your tasks, for example: analyze a dataset, filter data by conditions, or generate a visualization from your Excel source.
How to install
Prerequisites: you need Python installed on your system. You will also use a runtime helper to start MCPs locally and a package manager to install dependencies.
# Create a new project folder for the MCP server
# Using uvx runtime (recommended)
uv init excel-mcp-server
cd excel-mcp-server
uv venv
# Activate the virtual environment (choose the appropriate command for your OS)
# macOS/Linux
source .venv/bin/activate
# Windows
# .venv\Scripts\activate
Configuration and usage notes
To run and connect the server from Claude Desktop, you configure Claude to start the MCP process via a stdio command. Use the following configuration snippet to tell Claude Desktop how to start the server.
{
"mcpServers": {
"command": "uvx",
"args": [
"mcp-excel-server"
],
"env": {
"PYTHONPATH": "/path/to/your/python"
}
}
}
Starting the server and connecting
After you install the dependencies, start the server from your CLI using the runtime command shown above. Your MCP client can then connect to the local process to send requests for reading Excel files, performing analyses, and generating visualizations.
Security and best practices
- Read files only from approved paths and avoid processing untrusted sources. - Enforce file size limits to prevent resource exhaustion. - Implement safeguards to avoid accidental file overwrites. - Sanitize inputs and limit data transformations to safe, explicit operations.
Examples and prompts
Common tasks you can perform include: analyze an Excel file, create a bar chart from a dataset, filter records by a condition, or generate a pivot table from a worksheet.
Available tools
read_excel
Read Excel files in multiple formats (XLSX, XLS, CSV, TSV, JSON) and return data for further processing.
get_excel_info
Retrieve file information such as size, format, and metadata.
get_sheet_names
List all worksheet names within a given Excel file.
analyze_excel
Perform statistical analysis and descriptive data exploration on Excel data.
filter_excel
Filter data by conditions to narrow down results.
pivot_table
Create pivot tables from Excel data to summarize and aggregate information.
data_summary
Generate comprehensive summaries of datasets, including quality checks.
export_chart
Generate charts (line, bar, scatter, histogram) from Excel data and export as images.
write_excel
Write new Excel files or create updates to existing ones.
update_excel
Apply updates to existing Excel files based on new data or transformations.