@truecalc/mcp-local

Run TrueCalc Local — a native MCP server exposing TrueCalc's spreadsheet document engine (read/edit cells, formulas, formatting, charts, pivots, and more, over 70 tools) — with no install step:

npx -y @truecalc/mcp-local

This package is a thin wrapper: npx resolves it, its optionalDependencies bring in the prebuilt truecalc-mcp-local binary for your OS/CPU (@truecalc/mcp-local-darwin-arm64, @truecalc/mcp-local-darwin-x64, @truecalc/mcp-local-linux-x64, @truecalc/mcp-local-win32-x64), and the truecalc-mcp-local bin script execs it with stdio inherited. The server itself is the same Rust mcp-server binary built from truecalc/pro — one implementation, no second copy of tool behavior to keep in sync.

This is a paid product ($49, one-time license). The binary gates every tool call except license:activate behind a valid, locally-cached license — see license:activate in the parent repo's README for the full activation, device-binding, and re-validation flow. Buy a key at https://buy.polar.sh/polar_cl_n4cNoheqSQgeTpENhUaWOVzTA3ENvI1jkNhzC2fY6fS (the same URL mcp-server itself points an unlicensed caller at — TRUECALC_CHECKOUT_URL's default in src/commands/license/gate.rs).

MCP client configuration

Add this to your client's MCP server config (e.g. Claude Desktop's claude_desktop_config.json):

{
  "mcpServers": {
    "truecalc-local": {
      "command": "npx",
      "args": ["-y", "@truecalc/mcp-local"]
    }
  }
}

Restart the client, then call the license:activate tool with your license key before using any other tool.

Supported platforms

macOS (arm64, x64), Linux (x64), Windows (x64). Linux arm64 is a planned fast-follow, not yet published. On an unsupported platform, running npx -y @truecalc/mcp-local prints an actionable error naming the platforms that are supported instead of failing silently or with a stack trace.

Learn more

• truecalc/pro — full tool documentation, the MCP server's design, and cargo build --release --bin mcp-server for building from source.