SumOffice — real Word and Excel for agents

Real Word and Excel for agents: open your .docx/.xlsm, read, propose, apply, get it back intact.

Otherv0.3.1

SumOffice MCP server — real Word and Excel for agents

One server, two ways to run it. The agent opens your .docx / .xlsx / .xlsm, reads it, proposes a change, you approve, the file comes back intact — Excel and Word open the result without a repair dialog. Macros (VBA) and Power Query travel with the file.

Registry name: com.sumoffice/office · page with proof: https://sumoffice.com/mcp · image: docker.io/hissih/sumoffice-mcp

Remote — nothing to install

https://view.sumoffice.com/mcp (streamable HTTP).

claude mcp add --transport http sumoffice https://view.sumoffice.com/mcp

Clients without HTTP support: npx -y mcp-remote https://view.sumoffice.com/mcp (see examples/).

Local over stdio — local file paths

docker run -i --rm -v "$PWD:/work" hissih/sumoffice-mcp

The server runs on your machine and accepts path in document_open_file (paths under /work). The file itself is opened in a private, short-lived editor session on the SumOffice server and deleted after the session; nothing in the file is executed.

Tools

Documents (.docx)Spreadsheets (.xlsx/.xlsm/.xlsb)Both
document_open_file, document_open, document_describe, document_read, document_find, document_comments, document_propose_replacementdocument_applysheet_describe, sheet_read, sheet_find, sheet_propose_editssheet_apply, macro_list, macro_read_source, macro_plan, query_list, query_explain, workbook_inspectdocument_save_copy, document_export_pdf

propose_* never writes: it returns a diff for the person or the client to approve; *_apply applies exactly that proposal. Every step is listed in the response, so the agent cannot change a file silently.

Examples

  • examples/claude-desktop.json — Claude Desktop (claude_desktop_config.json), local stdio via Docker.
  • examples/cursor-mcp.json — Cursor (.cursor/mcp.json), remote HTTP.
  • examples/claude-code.sh — Claude Code, both variants.
  • examples/docker-compose.yml — the local server as a compose service with a mounted folder.

What it does not do yet

  • One editor session per document at a time; a second agent on the same file gets read-only.
  • Power Query definitions are preserved, not refreshed, in the server session.
  • Macros are read and routed (which will run natively, which stay in Excel); they are not executed by the MCP server.

Limits and privacy

Free, no account. Remote: per-address daily quota; files are deleted after the session or 24 hours at most, never used for anything else. Details: https://sumoffice.com/app-privacy.html

Licence

This repository (documentation, manifest, examples) is MIT. The server image is free for evaluation and for use with the public endpoint; production use inside an organisation is licensed per application — https://sumoffice.com/download#server. Questions: hello@sumoffice.com

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
docker run -i --rm docker.io/hissih/sumoffice-mcp:0.3.1

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "com-sumoffice-office": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/hissih/sumoffice-mcp:0.3.1"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

docker.io/hissih/sumoffice-mcp:0.3.1docker

Compatible MCP Clients

SumOffice — real Word and Excel for agents works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More