# SumOffice — real Word and Excel for agents

> SumOffice — real Word and Excel for agents is a freemium MCP server for files and documents. Open, edit and save Word and Excel files through an approval-gated MCP server. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, API, CLI, self-hosted
- **Website:** https://sumoffice.com/mcp
- **Repository:** https://github.com/sumofficeapp/sumoffice-mcp
- **MCP Registry name:** com.sumoffice/office
- **Categories:** files and documents, productivity
- **Listing updated:** 2026-11-16

## About

Edits never touch the original file. Each session opens the document in a private editor on SumOffice's server in Frankfurt, and every change is proposed first, previewed by the engine, and only written when the agent calls the apply step. A stale proposal or an edit outside the previewed window is refused with a reason rather than applied on a best-effort basis.

On the spreadsheet side the agent can read values and formulas, list and read VBA macro source, and inspect Power Query steps. Macros are read and planned but never run, and queries are preserved rather than refreshed. Edited files come back as a copy: a macro workbook returns as .xlsm with the VBA project untouched, and a document can also be exported to PDF.

The server runs remotely over streamable HTTP with no account or key, or as a Docker image over stdio for local paths. Sessions expire after 10 minutes of silence, with five concurrent sessions per server and files deleted within 24 hours. The repository's docs and examples are MIT; the server image is free to evaluate and with the public endpoint, while production use inside an organisation is licensed.

## Features

- **Propose then apply edits:** Cell edits (up to 20 cells) and single-paragraph replacements are previewed first and written only on an explicit apply call.
- **Macro and query reading:** Lists and reads VBA source and explains Power Query steps without running or refreshing anything.
- **Intact file round trip:** Saved copies keep macros, styles and layout so Excel and Word open them without a repair prompt.
- **Many formats:** Opens .docx, .doc, .odt, .xlsx, .xlsm, .xlsb, .xls and .ods files up to 50 MB.
- **PDF export:** Renders the document with the engine and returns a PDF with the page count.
- **Remote or Docker:** Connect over streamable HTTP or run the Docker image over stdio with a mounted folder.

## Good for

- Have an agent fix a formula or label in a macro-enabled workbook without damaging the VBA project
- Rewrite a clause in a Word contract and review before/after text before accepting
- Audit which Power Query steps and macros a workbook depends on
- Produce a PDF of an edited document to check the layout
- Search a large spreadsheet or document for a value from an agent chat

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://view.sumoffice.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "office": {
      "url": "https://view.sumoffice.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "office": {
      "type": "http",
      "url": "https://view.sumoffice.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "office": {
      "serverUrl": "https://view.sumoffice.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "office": {
      "type": "http",
      "url": "https://view.sumoffice.com/mcp"
    }
  }
}
```

## Tools

- `document_open_file`: Open a Word or spreadsheet file by URL, base64 or local path
- `document_open`: Open a demo file by name
- `sheet_describe`: List tabs, used ranges and revision
- `sheet_read`: Read values and formulas of a range
- `sheet_find`: Search a workbook
- `macro_list`: List VBA entry points
- `macro_read_source`: Read VBA source
- `macro_plan`: Plan macro routing without running anything
- `query_list`: List Power Query queries
- `query_explain`: Explain Power Query steps and load targets
- `workbook_inspect`: Inspect the whole application model
- `document_describe`: Describe a document
- `document_read`: Read paragraphs as a window
- `document_find`: Search a document
- `document_comments`: Read comments and tracked changes
- `sheet_propose_edits`: Preview cell edits
- `sheet_apply`: Apply a previewed cell edit
- `document_propose_replacement`: Preview a paragraph replacement
- `document_apply`: Apply a paragraph replacement
- `document_save_copy`: Get the edited file as a 24-hour download link
- `document_export_pdf`: Export the document to PDF

## FAQ

### Does it change my original file?

No. Changes live in the session's editor and come back as a downloadable copy.

### Does it run macros?

Not in this version. The agent can list, read and plan around VBA, but nothing is executed.

### Do I need an account?

No account or key is needed for the public endpoint; the README describes it as free with a per-address daily quota.

### How long are files kept?

Files are deleted after the session or after 24 hours at most.

### Is SumOffice — real Word and Excel for agents free?

SumOffice — real Word and Excel for agents has a free plan, with paid plans for more usage or features.

### How do I add SumOffice — real Word and Excel for agents to Claude Code?

Run this command in your terminal: claude mcp add --transport http office https://view.sumoffice.com/mcp

### What are the best alternatives to SumOffice — real Word and Excel for agents?

The closest alternatives to SumOffice — real Word and Excel for agents are Ha MCP, Concord MCP, note1, ASTra and CalderFlow.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/sumoffice-real-word-and-excel-for-agents
