
Excel MCP Server
Create, edit, format and chart .xlsx files, no Excel needed.
- 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)
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).
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.
| Tool | What it is for |
|---|---|
add_conditional_format | Adds colour scales, data bars, icon sets or highlight rules to a range. |
add_data_validation | Adds dropdown lists or value limits to cells. |
add_slicer | Adds a slicer button panel to filter a PivotTable or table. |
add_sparklines | Draws tiny in-cell line, column or win/loss charts. |
clear_range | Empties a block of cells, keeping or removing formatting. |
copy_range | Copies cells to another place, with paste-special options. |
copy_sheet | Duplicates a worksheet. |
create_chart | Builds a native Excel chart, from bar and line to waterfall, treemap and funnel. |
create_pivot_table | Builds a real PivotTable that Excel can refresh, with grouping and calculated fields. |
create_sheet | Adds a new worksheet. |
create_workbook | Makes a new, empty Excel file. |
delete_chart | Removes a chart. |
delete_defined_name | Removes a named range. |
delete_image | Removes a picture from a sheet. |
delete_note | Removes a cell note. |
delete_pivot_table | Removes a PivotTable. |
delete_rows_or_columns | Deletes rows or columns and fixes every formula that pointed at them. |
delete_sheet | Deletes a worksheet. |
delete_slicer | Removes a slicer. |
delete_sparklines | Removes sparklines. |
export_csv | Saves a range out as a CSV file. |
format_range | Sets fonts, fills, borders and number formats. |
goal_seek | Changes one input until a formula hits the target you set. |
import_csv | Pulls a CSV or TSV into a sheet and turns numbers and dates into real values the way Excel's own import does. |
import_workbook | Uploads a workbook to a remote server so it can be edited. |
insert_image | Places a picture on a sheet. |
insert_rows_or_columns | Inserts rows or columns and keeps every formula reference right. |
merge_cells | Merges or unmerges cells. |
rename_sheet | Renames a worksheet. |
replace_cells | Finds and replaces text or values. |
set_defined_name | Creates or updates a named range. |
set_note | Adds or edits a note on a cell. |
set_sheet_layout | Sets column widths, frozen panes, grouping, print setup and protection. |
set_table | Turns a range into an Excel table, with totals row and calculated columns. |
set_workbook_settings | Changes workbook-wide options such as calculation mode. |
sort_range | Sorts rows by one or more columns. |
transform_range | Cleans data: removes duplicates, splits text to columns or fills a series. |
write_range | Writes values, formulas, dates or links into cells. |
Only reads8 tools · Looks things up and changes nothing.
| Tool | What it is for |
|---|---|
describe_sheet | Summarises one sheet: used range, headers, tables, charts and frozen panes. |
describe_workbook | Lists a workbook's sheets, tables, names and sizes, as a first look. |
export_workbook | Sends a workbook from the server back to you when it runs remotely. |
find_cells | Searches for values or formulas across a sheet. |
list_workbooks | Lists the Excel files in the allowed folders. |
read_range | Reads cell values and formulas, working out formula results even if the file was never opened in Excel. |
read_vba | Shows the macro code inside an .xlsm file without running it. |
trace_formula | Shows 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 mcp add excel -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooksWhere it goes: ~/.cursor/mcp.json, or .cursor/mcp.json in a project
{
"mcpServers": {
"excel": {
"command": "uvx",
"args": [
"excel-mcp-server",
"stdio",
"--allow-dir",
"/path/to/workbooks"
]
}
}
}Where it goes: claude_desktop_config.json (Settings → Developer → Edit Config)
{
"mcpServers": {
"excel": {
"command": "uvx",
"args": [
"excel-mcp-server",
"stdio",
"--allow-dir",
"/path/to/workbooks"
]
}
}
}Easiest route: download excel-mcp-server.mcpb from the project's latest GitHub release and open it, and Claude asks which folder the server may use. The JSON below is the manual route; if Claude says it cannot find uvx, swap uvx for the full path that which uvx prints.
Where it goes: .vscode/mcp.json in your project (note the servers key)
{
"servers": {
"excel": {
"type": "stdio",
"command": "uvx",
"args": ["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.
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 mcp add excel -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooksWhere it goes: ~/.cursor/mcp.json, or .cursor/mcp.json in a project
{
"mcpServers": {
"excel": {
"command": "uvx",
"args": [
"excel-mcp-server",
"stdio",
"--allow-dir",
"/path/to/workbooks"
]
}
}
}Where it goes: claude_desktop_config.json (Settings → Developer → Edit Config)
{
"mcpServers": {
"excel": {
"command": "uvx",
"args": [
"excel-mcp-server",
"stdio",
"--allow-dir",
"/path/to/workbooks"
]
}
}
}Easiest route: download excel-mcp-server.mcpb from the project's latest GitHub release and open it, and Claude asks which folder the server may use. The JSON below is the manual route; if Claude says it cannot find uvx, swap uvx for the full path that which uvx prints.
Where it goes: .vscode/mcp.json in your project (note the servers key)
{
"servers": {
"excel": {
"type": "stdio",
"command": "uvx",
"args": ["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.
Where it goes: ~/.codex/config.toml, shared by the Codex CLI, IDE extension and ChatGPT desktop app
[mcp_servers.excel]
command = "uvx"
args = ["excel-mcp-server", "stdio", "--allow-dir", "/path/to/workbooks"]Or run: codex mcp add excel -- uvx excel-mcp-server stdio --allow-dir /path/to/workbooks
Where it goes: ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"excel": {
"command": "uvx",
"args": [
"excel-mcp-server",
"stdio",
"--allow-dir",
"/path/to/workbooks"
]
}
}
}Where it goes: Not supported
ChatGPT only connects to remote servers. You can host this one with uvx excel-mcp-server streamable-http behind HTTPS, but ChatGPT cannot send the bearer token, so it is not a good fit.
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.
| Setting | What it does |
|---|---|
--allow-dirCommand line flag | Only lets it open workbooks in this folder. Repeat for more folders. Strongly recommended.--allow-dir /path/to/workbooks |
EXCEL_FILES_PATHEnvironment variable | The same folder limit set through the environment. Separate folders with : on Mac and Linux or ; on Windows. |
--read-onlyCommand line flag | Offers only tools that cannot change files. Also EXCEL_MCP_READ_ONLY=1. |
--toolsCommand line flag | Loads only the core tools plus the areas you list, which saves a lot of context.--tools data,charts |
--allow-vba-writeCommand line flag | Adds tools that write macro code. Off by default; macros are never run either way. |
--max-file-mbCommand line flag | Largest workbook it will open. Defaults to 100 MB. |
EXCEL_MCP_AUTH_TOKENEnvironment variable | Bearer token clients must send when the HTTP server listens beyond localhost. |
--portCommand line flag | Port 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

One small server for Postgres, MySQL, MariaDB, SQL Server, Oracle and SQLite.
- Tools
- 2
- Runs on
- Your computer
- Licence
- MIT
- Stars
- 3.7K

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'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 Postgres from chat: projects, branches, SQL and migrations tested on a branch.
- Tools
- 65
- Runs on
- Hosted
- Licence
- MIT
- Stars
- 658

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
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