ironcalc-mcp
This MCP server enables creating, loading, editing, and saving Excel (.xlsx) workbooks via the IronCalc engine, allowing direct agent interaction without code generation.
Workbook Management: Create new workbooks with locale, language, and timezone settings; load and save XLSX files; inspect metadata, sheets, and dimensions; set properties; undo/redo actions.
Cell Operations: Read individual cells or ranges (content, formatted value, type); write single cells or batch ranges; set formulas (prefixed with =); apply array formulas; clear ranges; paste tab-delimited CSV data.
Sheet Management: Add, delete, rename, duplicate, move, hide/unhide sheets; set tab colors; toggle gridlines.
Row/Column Operations: Insert, delete, move, auto-fill rows and columns; set widths and heights; hide/unhide ranges; freeze top rows or left columns.
Formatting: Get and set cell styles (font, fill, border, alignment, number format); apply borders to ranges.
Named Styles: List, create, update, delete, and apply named styles.
Conditional Formatting: Manage rules: list, add, update, delete, and reorder.
Defined Names: Create and manage workbook- or sheet-scoped named ranges.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ironcalc-mcpCreate a budget with formulas and save it"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ironcalc-mcp
MCP server for the IronCalc spreadsheet engine. Create, read, edit, and save xlsx files through the Model Context Protocol.
Built on the typed high-level API in IronCalc 0.8.3. It exposes workbook editing, formulas, styles, structure, names, conditional formatting, and xlsx persistence through MCP.
Motivation
I was really inspired by paper.design's real-time MCP workflow, where exposing a design tool via MCP enables custom, extensible agent workflows that feel native rather than bolted on.
Current AI-spreadsheet integrations (like Claude's cowork mode for Excel) add an unnecessary layer of abstraction - the agent writes Python code that manipulates Excel, instead of talking to the spreadsheet directly. This MCP server removes that indirection. Agents read cells, write formulas, and get evaluated results in one hop. No codegen middleman, no openpyxl glue scripts.
Huge thanks to the IronCalc contributors - their Python SDK API is so clean that this entire MCP server is basically thin wrappers. The hard work is all theirs.
Current limitation: the server works with an in-memory workbook - load a file, edit it, save it back. There's no real-time streaming to a running IronCalc UI yet. The engine already has a diff queue for syncing, so the plumbing is there. If IronCalc adds a WebSocket bridge to their web app, we can wire up live sync and get a true reactive workflow - agent edits appearing in the browser as they happen.
Related MCP server: Excel MCP Server
Quick start
uvx ironcalc-mcpClaude Code
claude mcp add ironcalc -- uvx ironcalc-mcpClaude Desktop / Cursor
Add to your MCP config:
{
"mcpServers": {
"ironcalc": {
"command": "uvx",
"args": ["ironcalc-mcp"]
}
}
}Examples
Build a spreadsheet from scratch
Create a budget with formulas and save itAudit an existing xlsx for errors
Load quarterly_report.xlsx and find all #NAME?, #REF!, #VALUE! errors. Tell me which formulas are broken and why.Fix broken cross-sheet references
The P&L sheet was renamed but formulas in the DCF sheet still reference the old name. Find and fix all broken references.Build a financial model
Create a 5-year DCF model with revenue assumptions in one sheet, P&L in another, and free cash flow calculation in a third. Use =NPV() and =IRR() for valuation.Analyze and transform data
Load sales_data.xlsx, add a column with running totals, insert a summary row at the bottom, and save.Available tools (56)
Workbook
Tool | Description |
| Create an empty workbook with locale, timezone, and formula language |
| Load an xlsx file |
| Save to xlsx |
| Get metadata, theme, sheets, dimensions, states, and colors |
| Update name, locale, timezone, language, or theme |
| Undo the latest action |
| Redo the latest undone action |
Cells and ranges
Tool | Description |
| Get content, formatted value, and type |
| Read non-empty cells from an inclusive range |
| Set a value or formula |
| Batch-write cells with one evaluation pass |
| Set an array formula over a result area |
| Clear contents, formatting, or everything |
| Paste tab-delimited rows into a range |
Sheets
Tool | Description |
| Create a sheet |
| Delete a sheet |
| Rename a sheet |
| Set the tab color |
| Duplicate a sheet |
| Change sheet visibility |
| Reorder a sheet |
| Show or hide grid lines |
Rows and columns
Tool | Description |
| Insert or delete rows |
| Insert or delete columns |
| Move a contiguous row or column block |
| Size one column or an inclusive range |
| Size one row or an inclusive range |
| Hide or unhide inclusive ranges |
| Set frozen panes |
| Extend values and formulas from a source area |
Formatting
Tool | Description |
| Get font, fill, border, alignment, and number format |
| Update selected style properties on a cell or range |
| Apply inner, outer, side, or full borders |
Named styles and conditional formatting
Tool | Description |
| Inspect named styles |
| Manage named styles |
| Apply a named style to a range |
| List conditional formatting rules |
| Manage rules |
| Reorder rules |
Defined names
Tool | Description |
| List workbook- and sheet-scoped names |
| Create a defined name |
| Rename, re-scope, or update a defined name |
| Delete a defined name |
Contributing
git clone https://github.com/yolonir/ironcalc-mcp
cd ironcalc-mcp
just initjust init syncs the locked environment and installs the deterministic prek commit hook.
just test # Behavioral tests
just quality-check # Ruff, mypy, and ty
just quality-check src/path.py # Targeted quality checks
just precommit # Run all commit-time hooks
just format # Format and apply safe lint fixesPlease create a new branch for your changes and open a focused pull request against main.
License
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA robust solution that enables AI agents to create, read, modify, and convert Excel files through the Model Context Protocol without requiring Microsoft Office installation.6MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables AI agents to freely operate Excel spreadsheets, providing tools for workbook creation, cell manipulation, formatting, formula handling, and data export.1152ISC
- AlicenseAqualityDmaintenanceEnables AI assistants to perform comprehensive Microsoft Excel operations including data analysis, cell editing, advanced formatting, and VBA execution on Windows systems. It provides a structured workflow for managing workbooks and worksheets through a dedicated Model Context Protocol interface.5524MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to automate Microsoft Excel tasks such as reading/writing cells, formatting, creating charts, and managing sheets through natural language using the Model Context Protocol.1Apache 2.0
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
Persistent docs and memory for AI agents — read, write, organize & search a shared workspace.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/yolonir/ironcalc-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server