Get the FREE Ultimate OpenClaw Setup Guide →

mcp-excel

The Excel MCP Server is a powerful tool that enables natural language interaction with Excel files through the Model Context Protocol (MCP). It provides a comprehensive set of capabilities for reading, analyzing, visualizing, and writing Excel data.

Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
claude mcp add --transport stdio yzfly-mcp-excel-server uvx mcp-excel-server \
  --env PYTHONPATH="/path/to/your/python"

How to use

The Excel MCP Server provides a suite of tools for reading, analyzing, visualizing, and updating Excel-like data sources. It supports reading multiple formats (XLSX, XLS, CSV, TSV, JSON), performing data quality checks and descriptive statistics, generating pivot tables, filtering data, and creating visualizations such as line, bar, scatter plots, and histograms. Core operations include reading and inspecting Excel files, computing summaries, and exporting results and charts for reporting. Tools are exposed under categories such as File Reading, Data Analysis, and Data Visualization, enabling you to build data workflows that start with loading an Excel file and end with analytical outputs or visualization assets.

To use the server, run it in your environment via the provided MCP entry (for Claude Desktop integration, use uvx with the specified server name). Once running, invoke tools like read_excel to load a file, get_excel_info to inspect structure, analyze_excel for statistics, pivot_table to aggregate data, and export_chart to render visualizations. You can also write or update Excel files using write_excel and update_excel. The Resources section shows how to access files and previews through excel:// URIs for lightweight previews and information lookup.

How to install

Prerequisites:

  • Python installed on your system
  • uv (the Universal Verifier/runner) installed and accessible in PATH
  • Access to the MCP server source code (the excel-mcp-server project)

Installation steps:

  1. Create and activate a Python virtual environment (recommended):

    Using uv (recommended)

    uv init excel-mcp-server cd excel-mcp-server uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate

    Or using venv directly (alternative):

    python -m venv .venv source .venv/bin/activate # On Windows: .venv\Scripts\activate

  2. Install dependencies in editable mode so you can develop and test locally:

    Using uv

    uv pip install -e .

  3. Run the MCP server locally (example): uvx mcp-excel-server

  4. Optional Claude Desktop integration (as shown in the README): Ensure Claude Desktop is installed, then configure mcpServers entry in claude_desktop_config.json as demonstrated in the Integration section.

Notes:

  • Ensure your Python environment has access to the required dependencies (pandas, numpy, matplotlib, seaborn).
  • If your project uses a specific Python version, ensure uv is configured to use that interpreter.

Additional notes

Tips and notes:

  • Limit file paths to allowed directories to enhance security when reading files (per the Security Considerations).
  • Set environment variables like PYTHONPATH if your modules live outside the standard paths.
  • When generating visualizations, you can export charts as image files for reporting purposes.
  • The server supports reading multiple formats and provides functions to get file info and sheet names, which helps in building robust data pipelines.
  • If you encounter issues with dependencies, ensure you are using a virtual environment and that pip can fetch and install the required packages (pandas, numpy, matplotlib, seaborn).
  • For Claude Desktop integration, make sure the mcp-excel-server executable name matches what Claude expects and that the environment path to Python is correctly set.

Related MCP Servers

Sponsor this space

Reach thousands of developers