SumOffice — real Word and Excel for agents
RemoteAbout SumOffice — real Word and Excel for agents
SumOffice is an MCP server for agents that need to inspect and edit Word documents and Excel workbooks while preserving the original files. Proposed changes are shown for approval before they are applied, and edits are recorded in each response.
Key features
- 01Read and search Word documents and workbooks
- 02Propose changes before applying them
- 03Inspect macros and Power Query definitions
- 04Save copies and export PDFs
Use cases
- 01Review a .docx and approve proposed replacements
- 02Inspect workbook data and propose spreadsheet edits
- 03Check macros or Power Query without executing them
- 04Export an edited document as PDF
MCP support
Exposes document and spreadsheet tools to MCP clients through a remote Streamable HTTP endpoint or a local stdio server. The tools separate proposals from applying changes, requiring approval before writes.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://view.sumoffice.com/mcpclaude mcp add --transport http com-sumoffice-office https://view.sumoffice.com/mcp{"mcpServers":{"com-sumoffice-office":{"type":"http","url":"https://view.sumoffice.com/mcp"}}}Open in Cursor{"servers":{"com-sumoffice-office":{"type":"http","url":"https://view.sumoffice.com/mcp"}}}Open in VS Code{"mcpServers":{"com-sumoffice-office":{"type":"http","url":"https://view.sumoffice.com/mcp"}}}{"mcpServers":{"com-sumoffice-office":{"serverUrl":"https://view.sumoffice.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
21| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | enum | Yes | footnotes | comments | forms | rtl | wild-horse | workshop | workbook | functions | macros | queries | gep | vba-web | sqlite | order-desk | onrr | cashflow | offer | pivot | chart | notes | check | tools | xtools |
Details
From the project READMESumOffice 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_replacement → document_apply | sheet_describe, sheet_read, sheet_find, sheet_propose_edits → sheet_apply, macro_list, macro_read_source, macro_plan, query_list, query_explain, workbook_inspect | document_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: [email protected]
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.