SumOffice — real Word and Excel for agents
Server Details
Real Word and Excel for agents: open your .docx/.xlsm, read, propose, apply, get it back intact.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- SumOfficeApp/sumoffice-mcp
- GitHub Stars
- 0
- Server Listing
- SumOffice MCP server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 21 tools
Each tool targets a distinct resource (document vs workbook) and a specific operation (open, read, propose, apply, inspect, export). The only overlap is between document_apply and sheet_apply, but their scopes are clearly separated by file type and descriptions. Even macro_ and query_ tools are unique to their subdomains.
Tools follow a consistent <domain>_<verb> or <domain>_<verb>_<noun> pattern (e.g., document_read, sheet_find, macro_list, query_explain). The lone exception is document_comments, which uses a noun instead of a verb, but it is still clear and fits the read-only nature. Overall, the pattern is predictable and easy to navigate.
With 21 tools, the server sits in the 'heavy' range (16-25), but this is justified by covering two distinct file types (documents and workbooks) plus macros and queries. Each tool serves a specific purpose in the edit/inspect workflow, and none feel redundant. It is well-scoped for the stated 'real Word and Excel' goal.
The tool surface covers the full read-propose-apply-save lifecycle for both documents and workbooks, plus inspection capabilities for macros, queries, and the workbook model. Minor gaps exist—no delete/insert operations for paragraphs or cells, no macro execution, and no query refresh—but these are arguably intentional for safety and the core editing workflow is complete. Agents can accomplish most tasks without dead ends.
Available Tools
21 toolsdocument_applyApply a proposed paragraph replacementAInspect
Apply a proposal from document_propose_replacement to the document in this session's cabin (not to your original file). Stale proposal (the document moved on) is refused by the engine — propose again. Repeating an applied proposal is a no-op.
Inputs: proposal_id (required).
document_commentsComments and tracked changesBInspect
Comments (author, text, anchor, resolved) and tracked changes — up to 50.
Inputs: no named parameters.
document_describeWhat the document isAInspect
Name, pages, paragraphs, words, number of comments and tracked changes, whether track changes is on. For documents; call first.
Inputs: no named parameters.
document_export_pdfRender the document to PDFAInspect
Lay out the document as it is now in this session's cabin (after applied proposals, or as opened) and return a PDF download link valid for 24 hours, plus the page count. Documents only; for workbooks use document_save_copy.
Inputs: no named parameters.
document_findFind in the documentAInspect
Paragraphs containing the text (case-insensitive), with snippets around the match.
Inputs: query (required).
document_openOpen a demo document or workbookAInspect
Open one of the demo files by name: documents footnotes, comments, forms, rtl, wild-horse, workshop, offer, tools; workbooks workbook, functions, macros, queries, gep, vba-web, sqlite, order-desk, onrr, cashflow, pivot, chart, notes, check, xtools. Default is footnotes. For your own file use document_open_file. Opens a separate editor cabin for this session.
Inputs: slug (required).
document_open_fileOpen your own Word document or Excel workbookAInspect
Open YOUR file in a private editor cabin for this session: a .docx/.doc/.odt document or an .xlsx/.xlsm/.xlsb/.xls/.ods workbook, up to 50 MB. Give exactly one of: url (https link the server can fetch), base64 (file bytes; then name with the extension is required). Nothing in the file is executed. The file is kept for 24 hours and then deleted. After opening, use document_* tools for a document or sheet_* / macro_* / query_* / workbook_inspect for a workbook; sheet_propose_edits → sheet_apply and document_propose_replacement → document_apply change the copy in the cabin; document_save_copy returns a download link of the edited file.
Inputs: url, name, path, base64.
document_propose_replacementPropose replacing one paragraph's textAInspect
Propose the full new text of one paragraph (paragraph_index from document_read). Nothing changes yet: the editor core builds the change on a copy and returns before/after plus checks (numbers, dates, links kept). Then call document_apply with the proposal_id. Read the paragraph first.
Inputs: text (required), paragraph_index (required), reason.
document_readRead paragraphsAInspect
Paragraph text as a window: from = index of the first paragraph (0-based), count = how many (max 40). The answer carries next — where to continue, null at the end. A missing paragraph is a refusal, not an invention.
Inputs: from (required), count.
document_save_copySave a copy of the edited fileAInspect
Write the document or workbook as it is now in this session's cabin (after applied proposals) to a copy and return a download link valid for 24 hours. Your original file is never touched. A workbook with macros comes back as .xlsm with the VBA project intact; a document keeps its styles, comments and tracked changes.
Inputs: inline.
macro_listAInspect
List VBA modules and runnable macros (entry points) in this workbook with their route and blockers. Runs nothing.
Inputs: no named parameters.
macro_planAInspect
Plan a macro run without running it: route, whether the engine can run it natively, blockers, instruction budget.
Inputs: entrypoint (required), active_sheet.
macro_read_sourceAInspect
Read the source text of one procedure (module + procedure name from macro_list). Read-only; runs nothing.
Inputs: module (required), procedure (required).
query_explainAInspect
Explain one Power Query query by name: its steps in order, where it loads, its connection. Reads only; refreshes nothing.
Inputs: name (required).
query_listAInspect
List Power Query queries in this workbook: names, step chain, load target, connections. Reads only; refreshes nothing.
Inputs: no named parameters.
sheet_applyApply proposed cell editsAInspect
Apply a proposal from sheet_propose_edits to the workbook in this session's cabin (not to your original file); the engine recalculates. Refused if the workbook revision moved on since the proposal — propose again. Repeating an applied proposal is a no-op.
Inputs: proposal_id (required).
sheet_describeAInspect
Workbook overview: every sheet tab with its used range, the current revision, and the header row of the sheet that is open. Call this first, then pass the tab name you need as "sheet" to sheet_read and sheet_find.
Inputs: no named parameters.
sheet_findAInspect
Find cells whose value or formula contains the text (case-insensitive) in the used range of a sheet. ALWAYS pass "sheet" with the exact tab name when the workbook has more than one sheet: without it only the sheet that happens to be open is searched.
Inputs: query (required), sheet.
sheet_propose_editsAInspect
Propose new contents for up to 20 cells (formulas like =SUM(B2:B9), or numbers/text). Nothing changes in the workbook: the engine previews the edits on the current revision and reports what would change and whether errors appear; the person decides whether to apply. Read the cells first. Do not overwrite input numbers unless the task says so. Then call sheet_apply with the proposal_id.
Inputs: edits (required), sheet, reason.
sheet_readAInspect
Read a rectangular range like A1:F20 (max 60 rows × 26 columns): values and formulas. Empty cells are omitted. ALWAYS pass "sheet" with the exact tab name when the workbook has more than one sheet — without it you read whichever sheet happens to be open, and the answer will quietly be about the wrong sheet. Call sheet_describe first if you do not know the tab names.
Inputs: range (required), sheet.
workbook_inspectAInspect
Map the whole application model of this workbook in one call: sheets; VBA modules, procedures, which can run here and which are blocked and why; event handlers; external objects (CreateObject) and Windows API (Declare) dependencies; project references; Power Query queries; data connections; form controls, ActiveX, embedded objects (preserved). Runs nothing. Call this first for questions like 'how is this workbook built' or 'what does it depend on'.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Convert, create and edit Word, PowerPoint, Excel and PDF documents from any AI agent.
Word docs, Excel sheets and PowerPoint decks your agents create and edit, each with a private link.
An agent-first office suite Claude & ChatGPT read and write over one MCP URL.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to read, edit, and create Microsoft Word documents (.docx) with support for rich text, tables, and images, deployable locally or via SSE.3MIT
- AlicenseNot gradedqualityBmaintenanceLets any AI agent read and edit the Excel and Word documents a user already has open, attaching through COM so it sees unsaved edits, recalculated formulas, pivot tables, slicers and charts, and can bridge content between the two apps with journaling, undo, read-only mode and allowed-folder limits.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to read .docx files as text, apply batches of edits as native Word tracked changes, and finalize copies by scrubbing metadata and optionally locking them read-only.72 npmMIT
- AlicenseCqualityCmaintenanceEnables AI agents to create, read, and edit Word documents with tracked changes, comments, and template manipulation, including bulk text replacement and paragraph-level operations.100MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.