PlugWiki
Excel MCP Server logo

Excel MCP Server: community server for Claude, Cursor and Codex

CommunityLocal
GetPyPIexcel-mcp-serverharis-musa/excel-mcp-serverDocs

Lets your AI assistant create and edit Excel files, with charts, PivotTables and formulas, without Excel installed.

It lets Claude, Cursor, Codex and other assistants create and edit Excel workbooks for you, including data, formulas, charts, PivotTables and formatting. It works on .xlsx files directly, so you do not need Excel installed, and it runs on Windows, macOS and Linux. It is a community project by Haris Musa, and Microsoft has no Excel MCP server of its own. Give it one folder to work in, because otherwise it can open any Excel file on your computer.

Good for

  • Analysts who want Claude to build charts and PivotTables from a sheet of raw data
  • Finance and ops people who need to find out why a number in a workbook is wrong
  • Mac and Linux users who need real .xlsx output without owning Excel
  • Developers who want an agent to generate or clean up spreadsheets as part of a job

Works in

6 supported · 6 should work

Tap an app to see how to set it up and any known problems.

Install Excel MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the Excel MCP server to Claude Code. Run this command:
    
    claude mcp add excel --scope user -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires uv (Python), Python 3.11+.

Read-only mode: Add --read-only after stdio in the server arguments, so it can only read workbooks, never change them.

Replace /path/to/workbooks with the one folder the assistant may use; without --allow-dir it can open any Excel file you give a full path to. You do not need Microsoft Excel installed.

From the project README. Source.

Tools

  • Shows a workbook's sheets, names and settings at a glance

    Gives an overview of a workbook: its sheets and how much is on each, defined names, properties and calculation settings. It is the usual first step before reading or editing.

    Try: “What's in budget-2026.xlsx?”

    Read · describe_workbook

  • Shows everything on a sheet: tables, charts, PivotTables, notes and rules

    Describes one sheet in detail: the used range, frozen panes, merged cells and every object on it, such as tables, charts, PivotTables, slicers, images, notes, links, validation and conditional formats.

    Try: “What charts and tables are on the Summary sheet?”

    Read · describe_sheet

  • Reads cell values from a sheet, page by page for big sheets

    Reads the values in a block of cells as rows, with dates in a standard format, and returns large sheets in pages. Formulas that have no saved result are calculated for you where possible.

    Try: “Read the first 50 rows of the Sales sheet”

    Read · read_range

  • Finds cells that contain a word or value

    Searches a workbook for cells whose value contains or equals what you ask for and lists them by sheet.

    Try: “Find every cell that mentions Acme Corp”

    Read · find_cells

  • Lists the Excel files in a folder

    Lists the Excel files in a folder you name, with their sizes.

    Try: “Which Excel files are in my reports folder?”

    Files · list_workbooks

  • Shows which cells a formula depends on, to find why a number is wrong

    Audits a formula: it shows the cells, names and tables it uses or that use it, across sheets, and can evaluate it step by step like Excel's Evaluate Formula.

    Try: “Why is the total in Summary!F20 wrong? Trace where it comes from”

    Read · trace_formula

  • Shows the macro code inside an .xlsm workbook

    Shows the VBA macro code in an .xlsm or .xltm workbook, module by module. The code is only read, never run.

    Try: “Show me the macros in tracker.xlsm and explain what they do”

    Read · read_vba

  • Creates a new, empty Excel workbook

    Creates a new, empty Excel file at the path you give.

    Try: “Create a new workbook called q4-forecast.xlsx”

    Write · create_workbook

  • Writes values or formulas into cells

    Writes values or formulas into a block of cells, replacing what was there. Formulas are checked for unsafe functions before they are saved.

    Try: “Put these 12 monthly totals in column B of the Sales sheet”

    Write · write_range

  • Adds a chart, from simple bars to waterfall and treemap

    Adds or replaces a chart built from a range of cells. It supports column, bar, line, pie, scatter and other common types, plus newer ones such as waterfall, histogram, treemap and funnel.

    Try: “Make a line chart of monthly revenue from Sales!A1:B13”

    Write · create_chart

  • Builds a PivotTable that Excel can refresh

    Adds a real PivotTable that summarizes a block of data, with totals already filled in, which Excel can refresh later.

    Try: “Create a PivotTable of revenue by region and month”

    Write · create_pivot_table

  • Turns a range into an Excel table, or changes one

    Creates a formatted Excel table from a range, or changes an existing one: its options, calculated columns, totals row and size.

    Try: “Turn A1:F200 on the Orders sheet into a table with a totals row”

    Write · set_table

Read from the source code

Pros and cons

Good

  • No Microsoft Excel needed; works on Windows, macOS and Linux.
  • Real refreshable PivotTables, slicers, timelines and modern chart types.
  • Calculates formulas itself, so it can read results from files never opened in Excel.
  • Read-only mode and folder limits are built in.
  • Load only the tool groups you need to save context.
  • Free and open source under the MIT license, with an active maintainer.

Watch out

  • Can open any Excel file on your computer unless you set a folder.
  • No legacy .xls support.
  • Its formula engine covers about 260 functions, so some results stay blank until Excel opens the file.
  • Tool names changed in 2.0, so older guides and prompts no longer match.
  • A long list of security fixes in 2026 means old cached versions are risky.
  • The full tool set uses a lot of context.

Permissions

medium risk · 5 things to watch · 21 advisories

Medium risk

The assistant can overwrite cells, delete sheets and open any Excel file you can reach unless you limit it to a folder. Give it one folder, use read-only mode when you only need answers, and keep it on the latest version.

What it can do

Watch out for

  • It can open any Excel file unless you limit it

    Without a folder setting, any full path to an Excel file works. Add --allow-dir with the one folder it should use. github.com

  • Many security fixes landed in 2026

    Over 20 advisories were published this year, and all are fixed by version 2.2.5. Stay on the latest release. github.com

  • Workbooks can hide instructions

    Cells and notes in a file from someone else can try to steer the assistant. Check what it changes when you work on files you did not make. github.com

  • Macro writing is risky if you turn it on

    With macro writing on, it can save VBA code that runs once you enable macros in Excel. Read the code before you enable them. github.com

  • HTTP mode needs a token before you share it

    It only listens on your own computer by default. Set EXCEL_MCP_AUTH_TOKEN before opening it to other machines, and put HTTPS in front. github.com

Security advisories

21 known advisories, all fixed in a newer version.

Show all 21
Technical details
Turning on read-onlyStart the server with --read-only, or set EXCEL_MCP_READ_ONLY=1: only tools that do not change files are offered, and the VBA write tools are never offered.
Talks toNone in local mode; HTTP mode listens on 127.0.0.1:8017 by default

Alternatives

Use this server for most Excel work, since it runs anywhere without Excel. Pick mcp-server-excel if you are on Windows with Excel and need Power Query or live recalculation, and exstruct if you mainly want the assistant to read complex workbooks.

ServerOfficialRunsCan change thingsToolsGitHub stars
For Microsoft Excel
Excel MCP ServerThis pageCommunityLocalYes464.3K
mcp-server-excelCommunity–––836
exstructCommunity–––203
Other tools for the same job
negokaz excel-mcp-serverCommunity–––1K

What people say

People like how much of Excel it now covers, including real PivotTables, and worry most about what an agent can do with write access to spreadsheets.

What people like

  • Users building tools for Excel teams praise the 2.0 release with real PivotTables.
  • The maintainer answers issues quickly; none are open.

Common complaints

  • Security reviewers reported many missing input checks in 2026, all since fixed.
  • Tool names changed between versions, breaking older setups.
  • Run on a remote server, files are saved there rather than on your own computer.

In their words

Questions

Do I need Microsoft Excel installed?

No. It reads and writes .xlsx files directly, on Windows, macOS or Linux. You only need Excel, or another spreadsheet app, to open the results.

Is there an official Microsoft Excel MCP server?

No. Microsoft lists its own MCP servers for Word, mail, calendar, Teams and other Microsoft 365 apps, but none for Excel. This is a community project by Haris Musa.

Is it free?

Yes. It is open source under the MIT license and runs on your own computer.

Is it safe?

Safe enough if you set it up carefully. Limit it to one folder, use read-only mode when you only need answers, keep macro writing off, and stay on the latest version, since many security fixes shipped in 2026.

Can it delete my data?

Yes, unless read-only mode is on. It can clear ranges and delete rows, columns, sheets and charts, but it never silently overwrites a whole existing workbook.

Does it work with .xls or CSV files?

Not old .xls files. It can import a CSV or TSV file into a sheet and export a range as CSV.

Does it calculate formulas?

Yes, for about 260 common functions, so it can read results from files never opened in Excel. Anything it cannot match Excel on comes back blank, and Excel recalculates when you open the file.

Can it run macros?

No. It can read VBA code, and write it only if you turn that on, but it never runs it. Excel asks before enabling macros.

Can I run it on a server for my team?

Yes, in HTTP mode, with a token and HTTPS in front. Files are saved on that server, so use its export and import tools to move them.

How do I add it to Claude Desktop?

The simplest way is the Claude Desktop bundle in the install box above: open it and pick the folder the server may use.

Information

updated Nov 2, 2026

Publisher
Community
Package
excel-mcp-server
Registry
PyPI
Transport
stdio, Streamable HTTP
Auth
None
Version
2.2.3
License
MIT
Last commit
Oct 29, 2026
Open issues
0
Listed in
Official MCP registry

WebsiteDocsGitHubPyPIOfficial MCP RegistryChangelogIssues

Other Microsoft Excel MCP servers

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 12
  1. github.com · github.com
  2. Understand MCP server options in Agent 365 · learn.microsoft.com
  3. Excel MCP Server TOOLS.md · github.com
  4. github.com · github.com
  5. github.com · github.com
  6. github.com · github.com
  7. github.com · github.com
  8. github.com · github.com
  9. github.com · github.com
  10. github.com · github.com
  11. github.com · github.com
  12. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.