Lets AI agents inspect, edit, and recalculate Excel workbooks and create PivotTables without needing Microsoft Excel installed.
Also known as libraz/formulon-mcp, @libraz/formulon-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- 555
- Latest version
- —
- Last commit
- Oct 26, 2026
- License
- Apache-2.0
What is Formulon MCP?
Formulon lets AI agents inspect, edit, and recalculate Excel workbooks and create PivotTables without needing Microsoft Excel installed.
Summary generated from the project's README
About Formulon MCP server
Managing and modifying Excel workbooks through an AI agent is possible with formulon-mcp. This local stdio MCP server allows developers to give agents the ability to inspect, edit, and recalculate spreadsheet data without requiring Microsoft Excel to be installed on the host machine. It works by running via Node.js 22 or newer and can be integrated with clients like Claude Desktop, Claude Code, or Codex CLI using an interactive installer.
Users can configure specific Excel locales and host environments, such as Windows or Mac, to ensure correct date and number formatting. The server provides specialized tools for creating native Tables and PivotTables, authoring printable documents, and auditing formulas to find missing or overwritten entries. Because sessions live in memory, all changes are temporary unless the agent uses explicit output paths to save workbooks. This makes it a specialized tool for automated spreadsheet manipulation and data summarization tasks.
Written from the project's README. Every use case is checked against a quote from it.
How to install Formulon MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Formulon MCP in Claude Code
$ claude mcp add formulon-mcp -- npx -y @libraz/formulon-mcpInstall Formulon MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"formulon-mcp": {
"command": "npx",
"args": [
"-y",
"@libraz/formulon-mcp"
]
}
}
}Install Formulon MCP in VS Code
.vscode/mcp.json
{
"servers": {
"formulon-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@libraz/formulon-mcp"
]
}
}
}Install Formulon MCP in VS Code CLI
$ code --add-mcp '{"name":"formulon-mcp","type":"stdio","command":"npx","args":["-y","@libraz/formulon-mcp"]}'Install Formulon MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"formulon-mcp": {
"command": "npx",
"args": [
"-y",
"@libraz/formulon-mcp"
]
}
}
}Install Formulon MCP in Codex
$ codex mcp add formulon-mcp -- npx -y @libraz/formulon-mcpInstall Formulon MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.formulon-mcp] command = "npx" args = ["-y", "@libraz/formulon-mcp"]
Install Formulon MCP in Gemini CLI
$ gemini mcp add -s user formulon-mcp npx -- -y @libraz/formulon-mcpInstall Formulon MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"formulon-mcp": {
"command": "npx",
"args": [
"-y",
"@libraz/formulon-mcp"
]
}
}
}Automated checks
Ran Nov 15, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablelibraz/formulon-mcp is public and reachablegithub.com/libraz/formulon-mcp ↗Pass
- Package names this repository as its source@libraz/formulon-mcp names libraz/formulon-mcp as sourcenpmjs.com/package/@libraz/formulon-mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @libraz/formulon-mcpnpmjs.com/package/@libraz/formulon-mcp/v/0.11.0#provenance ↗Pass
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-26github.com/libraz/formulon-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @libraz/formulon-mcpPass
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubformulon-mcp
A local stdio MCP server for Formulon. Agents can inspect and edit Excel workbooks, recalculate formulas, author printable documents, preview ranges, audit copied formulas, and create native Tables and PivotTables.
Full documentation lives on the Formulon website. It covers tool inputs, responses, limits, and end-to-end examples.
Quick start
Requires Node.js 22 or newer; see engines. Register the server with the bundled interactive installer:
npx -y @libraz/formulon-mcp init
Choose Claude Code, Codex CLI, or Claude Desktop, then the Excel locale and host (Windows or Mac) that new sessions evaluate with. The locale sets number and date text, TEXT formats, text comparison, and double-byte text functions; it defaults to the system locale. Review the configuration changes and restart the client. Ask the agent to evaluate =SUM(10,20,30) using Formulon; the result is 60.
For scripted setup, pass the profile directly, for example init --profile win-365-ja_JP. A single session can still pick another profile when it is opened.
See installation for manual client configuration, local checkouts, and troubleshooting. Remove registration with npx -y @libraz/formulon-mcp uninstall.
Guides
| Task | Documentation |
|---|---|
| Edit a workbook template and save a copy | Workbook workflow |
| Create an invoice with formulas and print settings | Document authoring |
| Reproduce a form and inspect its appearance | Layout and previews |
| Find overwritten or missing formulas | Formula audit |
| Summarize sales data | Tables and pivots |
| Inspect tool inputs or discover a low-level method | Tools · Advanced API |
Sessions live in memory and disappear when the server stops. Use explicit output paths and review load/save diagnostics. Preview rendering is approximate; formula audits report review candidates. See the security model.
Development
yarn install
yarn run check
yarn test
Tests build and exercise dist/. The calculation engine is maintained in the separate Formulon repository.
License
Apache-2.0. See LICENSE.
Formulon MCP questions
How do I add Formulon MCP to Claude Code?
Run claude mcp add formulon-mcp -- npx -y @libraz/formulon-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Formulon MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.