Skip to content
MCP Shelf

Excel MCP Server

Create, edit, format and chart .xlsx files, no Excel needed.

View on GitHub
  • Package checked
  • ★ 4.3K GitHub stars
  • 50.6K downloads a week
  • Last commit 27 Oct 2026

What is Excel MCP Server?

Excel MCP Server is an open source MCP server that lets AI assistants create, read and edit .xlsx workbooks, including formulas, formatting, charts and pivot tables, without Microsoft Excel installed.

Tools
46
Runs on
Your computer
Licence
MIT
GitHub stars
4.3K

Good for

  • Turning data from a conversation into a real spreadsheet
  • Cleaning or reshaping existing workbooks
  • Reports generated on a schedule

You'll need

  • uv (for uvx)
Works withClaude CodeCursorClaude DesktopVS CodeCodexWindsurfEach has a ready-made config on the Install tab, built from the README.

Package checkedThe npm package called "excel-mcp-server" has no link to this project. The project publishes to PyPI under that name, so it runs with uvx.

Try asking Excel MCP Server

Once it is installed, ask your assistant things like:

  • Create a workbook with a monthly budget sheet and a chart of spending by category.
  • Add a pivot table to sales.xlsx that totals revenue by region.
  • Highlight every row in Sheet1 where the amount is over 1,000.

MCP Shelf take

We started Excel on our own test machine on 26 Oct 2026 and it answered with 46 tools. 8 of the 46 only read; the other 38 can change things. Every tool comes with a useful description, all of them say whether they change things, and the tool list costs about 3,200 tokens of context before you ask a thing. Other directories point at a package with the same name that belongs to someone else; the config on this page installs the real one. It sits 2nd of 10 in its category on our shelf by GitHub stars (4.3K, with 50.6K downloads a week).
MCP Shelf tests: numbers from our own runs, not the README · tested on 26 Oct 2026

What can Excel MCP Server read and change?

It can read

  • Excel files (.xlsx, .xlsm, .xltx, .xltm) and CSVs in the folders you allow

It can change

  • Creates and edits workbooks in those folders, saving each change in one go so a file is never left half-written
  • Never overwrites an existing workbook without being asked

Safer setup: Always pass --allow-dir, and add --read-only when you only want analysis. Leave --allow-vba-write off.

Excel MCP Server in more detail

This server works on Excel files directly, so it runs on any machine, including servers without Office. The assistant can read ranges, write values and formulas, format cells, add charts and pivot tables, and manage sheets.

It can run over stdio for desktop clients or over HTTP if you want to host it.

Made by
Haris Musa
Latest version
2.2.2 (21 Oct 2026)
PyPI package
excel-mcp-server
Downloads
50.6K a week
Last commit
27 Oct 2026
Setup checked
27 Oct 2026
Page updated
27 Oct 2026

What's in the pod

What tools does Excel MCP Server have?

We found 46 tools when we started it on 26 Oct 2026. 8 only read. The rest can change things, so keep your app's "ask before each tool call" setting on for them.

Changes things38 tools · Can create, edit, send or delete.

ToolWhat it is for
add_conditional_formatAdds colour scales, data bars, icon sets or highlight rules to a range.
add_data_validationAdds dropdown lists or value limits to cells.
add_slicerAdds a slicer button panel to filter a PivotTable or table.
add_sparklinesDraws tiny in-cell line, column or win/loss charts.
clear_rangeEmpties a block of cells, keeping or removing formatting.
copy_rangeCopies cells to another place, with paste-special options.
copy_sheetDuplicates a worksheet.
create_chartBuilds a native Excel chart, from bar and line to waterfall, treemap and funnel.
create_pivot_tableBuilds a real PivotTable that Excel can refresh, with grouping and calculated fields.
create_sheetAdds a new worksheet.
create_workbookMakes a new, empty Excel file.
delete_chartRemoves a chart.
delete_defined_nameRemoves a named range.
delete_imageRemoves a picture from a sheet.
delete_noteRemoves a cell note.
delete_pivot_tableRemoves a PivotTable.
delete_rows_or_columnsDeletes rows or columns and fixes every formula that pointed at them.
delete_sheetDeletes a worksheet.
delete_slicerRemoves a slicer.
delete_sparklinesRemoves sparklines.
export_csvSaves a range out as a CSV file.
format_rangeSets fonts, fills, borders and number formats.
goal_seekChanges one input until a formula hits the target you set.
import_csvPulls a CSV or TSV into a sheet and turns numbers and dates into real values the way Excel's own import does.
import_workbookUploads a workbook to a remote server so it can be edited.
insert_imagePlaces a picture on a sheet.
insert_rows_or_columnsInserts rows or columns and keeps every formula reference right.
merge_cellsMerges or unmerges cells.
rename_sheetRenames a worksheet.
replace_cellsFinds and replaces text or values.
set_defined_nameCreates or updates a named range.
set_noteAdds or edits a note on a cell.
set_sheet_layoutSets column widths, frozen panes, grouping, print setup and protection.
set_tableTurns a range into an Excel table, with totals row and calculated columns.
set_workbook_settingsChanges workbook-wide options such as calculation mode.
sort_rangeSorts rows by one or more columns.
transform_rangeCleans data: removes duplicates, splits text to columns or fills a series.
write_rangeWrites values, formulas, dates or links into cells.

Only reads8 tools · Looks things up and changes nothing.

ToolWhat it is for
describe_sheetSummarises one sheet: used range, headers, tables, charts and frozen panes.
describe_workbookLists a workbook's sheets, tables, names and sizes, as a first look.
export_workbookSends a workbook from the server back to you when it runs remotely.
find_cellsSearches for values or formulas across a sheet.
list_workbooksLists the Excel files in the allowed folders.
read_rangeReads cell values and formulas, working out formula results even if the file was never opened in Excel.
read_vbaShows the macro code inside an .xlsm file without running it.
trace_formulaShows what a formula depends on and what depends on it, step by step, to find a wrong number.

Grouped and described by us. The README on GitHub lists the inputs each tool takes.

How clearly it describes its tools to your assistant

Tools with a description
46 of 46
Say if they change things
46 of 46
Context it takes, at least
~3,200 tokens

Every tool says whether it only reads or can change things, so a client can ask before the risky ones.

From the tool list it sent us. The token figure counts names, descriptions and input names; the full schemas your client loads add more.

How do I install Excel MCP Server?

Quick install

Pick your app and paste this in. It follows the README's own install steps below.

Where it goes: Your terminal, in the project folder

Claude Code
claude mcp add excel -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks
Codex, Windsurf, ChatGPT and more →

Install steps from the Excel MCP Server README

The project's own instructions, copied from its README on GitHub on 10 Nov 2026 under its MIT licence. They are the source of truth; the ready-made configs further down are built from them. The full README is on GitHub.

Quick start

You need uv. Every client runs the server with uvx excel-mcp-server stdio; replace /path/to/workbooks with the folder the server may use. excelmcpserver.com has the same steps with copy buttons and one-click install links for Cursor and VS Code.

Claude Desktop (Chat): download excel-mcp-server.mcpb from the latest release and open it. Claude asks which folder the server may use.

Claude Code (the CLI, and the Code tab in Claude Desktop):

claude mcp add excel --scope user -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks

Cursor (~/.cursor/mcp.json), and most clients that use an mcpServers config:

{
  "mcpServers": {
    "excel": {
      "command": "uvx",
      "args": ["excel-mcp-server", "stdio", "--allow-dir", "/path/to/workbooks"]
    }
  }
}

VS Code with GitHub Copilot (.vscode/mcp.json, note the servers key):

{
  "servers": {
    "excel": {
      "type": "stdio",
      "command": "uvx",
      "args": ["excel-mcp-server", "stdio", "--allow-dir", "${workspaceFolder}"]
    }
  }
}
OpenAI Codex, Gemini CLI, Devin Desktop, and Claude Desktop without the bundle

OpenAI Codex (CLI, IDE extension and app):

codex mcp add excel -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks

Gemini CLI:

gemini mcp add -s user excel uvx excel-mcp-server stdio --allow-dir /path/to/workbooks

Devin Desktop:

devin mcp add -s user excel -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks

Claude Desktop, manual setup: open Settings, Developer, Edit Config, add the mcpServers JSON above to claude_desktop_config.json, and restart Claude.

Desktop apps often cannot find uvx, because they do not see your shell's PATH (common on macOS). Use its full path instead, which which uvx prints.

What you need first

  • uv (for uvx)

Add Excel MCP Server to your app

Pick your app for a ready-to-paste snippet and where it goes, built from the steps above.

Where it goes: Your terminal, in the project folder

Claude Code
claude mcp add excel -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks

Replace /path/to/workbooks with the folder the assistant may open. In stdio mode there is no default folder, so leave --allow-dir out only if you will always give full paths.

Checked against the project's own install docs on 27 Oct 2026: haris-musa/excel-mcp-server README.

Did this work for you?

Projects change their install steps often. If Excel MCP Server did not install, or something here no longer matches the project, tell us and we will check it against the README and fix the page.

New to this? See the setup guides for Claude Code, Cursor, Claude Desktop, VS Code, Codex and ChatGPT. If it will not start, test it in MCP Inspector and look up the error in Fixing MCP server errors.

Excel MCP Server not working? Common fixes

Claude Desktop cannot find uvx
Desktop apps miss your shell PATH, especially on macOS. Use the full path that which uvx prints.
File not found with a relative path
Relative paths start in the --allow-dir folder. Without that flag, give the full path to the file.
The agent is slow because of the tool list
Use --tools to load only the areas you need, such as data and charts.
A huge sheet is refused
Raise --max-file-mb or --max-loaded-cells, keeping an eye on memory.

How do I configure Excel MCP Server?

Names are exactly as the project spells them. Required ones are marked.

SettingWhat it does
--allow-dirCommand line flagOnly lets it open workbooks in this folder. Repeat for more folders. Strongly recommended.--allow-dir /path/to/workbooks
EXCEL_FILES_PATHEnvironment variableThe same folder limit set through the environment. Separate folders with : on Mac and Linux or ; on Windows.
--read-onlyCommand line flagOffers only tools that cannot change files. Also EXCEL_MCP_READ_ONLY=1.
--toolsCommand line flagLoads only the core tools plus the areas you list, which saves a lot of context.--tools data,charts
--allow-vba-writeCommand line flagAdds tools that write macro code. Off by default; macros are never run either way.
--max-file-mbCommand line flagLargest workbook it will open. Defaults to 100 MB.
EXCEL_MCP_AUTH_TOKENEnvironment variableBearer token clients must send when the HTTP server listens beyond localhost.
--portCommand line flagPort for the HTTP mode. Defaults to 8017.

Excel MCP Server FAQ

How do I add Excel MCP Server to Claude Code?

Run claude mcp add excel --scope user -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks, swapping in the folder that holds your spreadsheets. You need uv installed first. Check it with claude mcp list.

Do I need Microsoft Excel installed to use Excel MCP Server?

No. It reads and writes the .xlsx files itself and has its own formula engine, so it runs on Windows, macOS and Linux, including servers with no Office at all.

What can Excel MCP Server do to a spreadsheet?

Read and write ranges, write formulas, format cells, add charts, pivot tables and data validation, and add, copy or delete sheets. It works on the file on disk, not on a workbook open in Excel.

Is Excel MCP Server safe to use on my files?

It only opens workbooks inside the folders you pass with --allow-dir, and --read-only removes every tool that changes a file. It reads VBA code but writes it only if you start it with --allow-vba-write. Keep copies of workbooks that matter.

Is Excel MCP Server free?

Yes. It is MIT licensed and runs on your own machine through uvx, so there is no account and no API cost beyond your AI app.

Does Excel MCP Server work with Google Sheets?

Not directly, because it works on .xlsx files. Download the sheet as .xlsx first, or use a Google Workspace server that talks to Sheets through Google's API.

Why does Claude Desktop say it cannot find uvx?

Desktop apps often do not see your shell's PATH, especially on macOS. Run which uvx in a terminal and put that full path in the command field, or install the .mcpb bundle, which avoids the problem.

How do I make Excel MCP Server use fewer tokens?

Start it with --tools and a comma-separated list of the areas you need. The core tools stay and the rest are hidden, which shortens the tool list the assistant has to read on every turn.

How do I add Excel MCP Server to Cursor?

In ~/.cursor/mcp.json, or .cursor/mcp.json for one project, add an entry named excel that runs uvx excel-mcp-server stdio --allow-dir /path/to/workbooks. Save, and the tools show up in Agent chat.

Can I use Excel MCP Server in VS Code?

Yes, through GitHub Copilot. In .vscode/mcp.json, add a server named excel with type stdio that runs uvx excel-mcp-server stdio --allow-dir ${workspaceFolder}. ${workspaceFolder} limits the server to the open project, which is a sensible default for spreadsheets kept with the code.

Does Excel MCP Server work with Codex?

Yes. Run codex mcp add excel -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks in a terminal, or add an [mcp_servers.excel] table to ~/.codex/config.toml, which the Codex CLI and IDE extension share.

Two peas, one chat

Chat with AI about Excel

Opens a chat primed with Excel’s README and setup docs from this page, or add it in Cursor to use its tools.

The Cursor button opens Cursor and asks before it adds the server. Fill in any keys it needs in Cursor’s MCP settings.

Peas in a pod

What are the alternatives to Excel MCP Server?

How Excel MCP Server lines up against its neighbours on the shelf. See every databases and data server.

  • Excel MCP ServerThis pea

    Create, edit, format and chart .xlsx files, no Excel needed.

    Tools
    46
    Runs on
    Your computer
    Licence
    MIT
    Stars
    4.3K
  • DBHub

    One small server for Postgres, MySQL, MariaDB, SQL Server, Oracle and SQLite.

    Tools
    2
    Runs on
    Your computer
    Licence
    MIT
    Stars
    3.7K
  • MongoDB MCP Server

    Query, inspect and manage MongoDB databases and Atlas clusters, read-only if you like.

    Tools
    20
    Runs on
    Your computer
    Licence
    Apache-2.0
    Stars
    1.2K
  • ClickHouse MCP Server

    ClickHouse's own server: read-only SQL on your cluster, plus chDB for local files.

    Tools
    3
    Runs on
    Your computer
    Licence
    Apache-2.0
    Stars
    898
  • Neon MCP Server

    Neon Postgres from chat: projects, branches, SQL and migrations tested on a branch.

    Tools
    65
    Runs on
    Hosted
    Licence
    MIT
    Stars
    658
  • Redis MCP Server

    Redis's own server: keys, hashes, streams, JSON and vector search in plain English.

    Tools
    53
    Runs on
    Your computer
    Licence
    MIT
    Stars
    641

Pea-sics and how-tos

Guides that use Excel MCP Server

Full docs on GitHubharis-musa/excel-mcp-server

Something wrong on this page? Tell us.

For bots & AI agents

Machine-readable versions of Excel MCP Server and MCP Shelf. Fetch these instead of parsing this page.

This listing (.md)llms.txtllms-full.txtai.txtFull catalog (.md)API specMCP serverMCP manifestDeveloper docs