jonemo/openpyxl-mcp-server

## What is this?
A thin wrapper around the OpenPyXl Python library that exposes some of its features as Model Context Protocol (MCP) server. This allows Claude and other MCP clients to fetch data from Excel files.
Related links:
https://openpyxl.readthedocs.io/en/stable/index.html
https://modelcontextprotocol.io/quickstart/server
## Installation
### General Steps
1. Download the latest version of the executable from https://github.com/jonemo/openpyxl-mcp-server/releases. openpyxlmcpserver is for MacOS, openpyxlmcpserver.exe is for Windows.
2. For MacOS users, make sure to set executable permissions on the downloaded file: chmod a+x /path/to/openpyxlmcpserver (replace /path/to/ with your actual download location).
3. Configure your MCP Client. Most commonly this will be Claude Desktop, see instructions in next section.
Windows will try to talk you out of running a random executable downloaded from the internet.
You will have to click "Keep" or "Keep anyway" in various places to convince it to not delete the file.
The details of this depend on which browser you use and what your Windows Defender settings are.
Alternatively, if you don't trust my executables, you can also install the source version of the code directly from this repo. See the "Run with uvx" and "From Source" sections below.
### Run with uvx
If you have uv installed, you can skip the executable and let uvx install and run the server directly from this repo.
In the Claude Desktop configuration below, use this instead of the path to the executable:
json
"mcpServers": {
"inspectexcelxlsxfile": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/jonemo/openpyxl-mcp-server",
"openpyxl-mcp-server"
This runs the latest commit on main.
To stay on a specific release, append its tag to the URL, for example git+https://github.com/jonemo/openpyxl-mcp-server@v0.2.0.
### Configuring Claude Desktop
Note that this only works with the Claude Desktop app, not with Claude running in the web browser.
1. Have Claude Desktop installed.
2. Have the MCP server executable downloaded (see previous section).
This assumes that you have downloaded the executable to your Downloads folder.
You can use any other folder, adjust the paths in the configuration below accordingly.
3. In Claude Desktop, open the "Settings..." menu:
4. Navigate to the "Developer" section of the settings.
5. Click "Edit Config". This will create a config file for MCP servers if you didn't have one already.
The default location of this file is:
macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
Windows: %APPDATA%\Claude\claudedesktopconfig.json
6. On MacOS, add the following to your claudedesktopconfig.json.
Replace with your MacOS username.
If you already use other MCP servers, you'll have to merge the JSON into the existing contents.
json
"mcpServers": {
"inspectexcelxlsxfile": {
"command": "/Users/ /Downloads/openpyxlmcpserver",
"args": []
7. On Windows, add the following to your claudedesktopconfig.json.
Replace with your MacOS username.
If you already use other MCP servers, you'll have to merge the JSON into the existing contents.
json
"mcpServers": {
"inspectexcelxlsxfile": {