excel-mcp-csharp

High-performance Excel MCP (Model Context Protocol) server for AI assistants like Claude.

Features

• Read, write, search, and analyze Excel files (.xlsx / .xls)
• Smart compressed overviews for large spreadsheets
• Table detection, filtering, and sorting
• Cell formatting, comments, and named ranges
• Merged cell support
• Cross-platform: macOS, Linux, Windows

Quick Start

1. First-Time Setup (License)

This server requires a machine-specific license. Run setup to get your machine ID and install the license:

npx excel-mcp-csharp --setup

The setup wizard will:

1. Display your Machine ID — provide this when requesting a license
2. Prompt you to enter the path to your .license file
3. Validate and install the license

2. Configure MCP

Add to your .mcp.json (Claude Code) or Claude Desktop config:

{
  "mcpServers": {
    "excel-mcp-csharp": {
      "command": "npx",
      "args": ["-y", "excel-mcp-csharp", "--stdio"]
    }
  }
}

Requirements

• Node.js >= 16 (for npx)
• .NET 8 Runtime — auto-installed on first run if not present

Available MCP Tools

| Tool | Description | |------|-------------| | get_excel_brief | Get file overview with sheet and region info | | get_smart_overview | Smart compressed overview of Excel regions | | search_in_range | Search for keywords with highlighting | | query_table | Filter and sort table data | | analyze_table | Column-level statistics and analysis | | detect_tables | Auto-detect table regions | | write_excel_data | Write data to cells | | set_cells_fmt_step_by_step | Apply text and table formatting | | manage_sheets | Add/delete/rename/copy/move worksheets | | manage_rows_columns | Insert/delete rows and columns | | find_replace | Find and replace values | | set_row_col_size | Set row heights and column widths | | manage_named_ranges | Manage named ranges | | manage_comments | Add/delete cell comments | | read_comments | Read cell comments | | create_excel | Create new Excel files | | scan_dir_sheets | Scan directory for Excel files |

License

This software requires a machine-specific license file. Run npx excel-mcp-csharp --setup for setup instructions, or contact the developer for licensing information.