Skip to content

OfficeAgent.NET 1.2.0

Choose a tag to compare

View all tags
@ilia-sokolov ilia-sokolov released this 14 Oct 07:53
· 41 commits to main since this release
v1.2.0
abdbd90

Highlights

  • The MCP server runs without .NET. Each release now carries a self-contained executable for Windows, macOS and Linux on x64 and Arm64, and a bundle for Claude Desktop on Windows and macOS: open the .mcpb file, pick a folder, and Claude can edit the .docx, .pptx and .xlsx files in it.
  • Formulas can be saved with their results. The new optional OfficeAgent.Excel.Calculation package calculates the formulas an edit writes, for an allowlist of functions each checked against a known value, and stores the results in the workbook. Previewers, data pipelines and inspection then see values instead of empty cells. Every formula it does not calculate is reported with the reason, and a plan that introduces a formula error such as #DIV/0! can be refused instead of saved.
  • More of Word is reachable. A plan can turn existing text into a hyperlink (link), merge table cells (mergeTableCells), add a paragraph to a list the document already has so a new clause continues the template's numbering (numberingId), and read or set the compatibility mode Word lays the document out in.
  • Decks and workbooks take core properties too. setProperty on core/title, core/creator and the other core properties now works on .pptx and .xlsx as it does on .docx.

Reliability and compatibility

Every new capability is opt-in or additive. Calculation is off unless a host or connection turns it on, and the public API and wire contract change only by addition. Tool results gain a calculation field, which is null unless a workbook was calculated.

Three changes affect output for existing callers:

  • setCell now stores functions added after Excel 2007 with the prefix Excel writes for them, such as _xlfn.STDEV.S. Without it Excel showed #NAME? for 160 functions, TEXTJOIN, XLOOKUP and IFS among them. Inspection reports formulas as stored, prefix included.
  • A tracked deletion is now a single revision. It previously wrote an empty insertion beside the deletion, which Word's Review pane counted as a second change.
  • Accepting or rejecting a tracked move now removes the range markers around it.

The MCP server also targets net10.0, and the container image and standalone downloads run on the .NET 10 runtime, at 10.0.13, the October 2026 security release that fixes remote code execution and privilege escalation issues in ASP.NET Core and the runtime. The libraries still target netstandard2.0 and net8.0; .NET 8 support ends on 10 November 2026, and a .NET 10 application consumes the net8.0 packages unchanged. A package whose main part has no root element now fails with an InvalidOperationException that names the part, instead of a later NullReferenceException.

The native Office record was rerun on Office 16: 77 of 77 cases pass, including Excel agreeing with all 107 calculated formulas, and Word, PowerPoint and Excel each opened and refused their corrupt control file. The 1.1.0 record had counted those controls as refused without Office opening them.

Install

dotnet add package OfficeAgent.Core --version 1.2.0
dotnet add package OfficeAgent.Word --version 1.2.0
dotnet add package OfficeAgent.Excel.Calculation --version 1.2.0
dotnet tool install --global OfficeAgent.Mcp --version 1.2.0
docker pull ghcr.io/ilia-sokolov/officeagent-mcp:1.2.0

Without .NET, download officeagent-mcp-<runtime>.zip or .tar.gz from this release, or the .mcpb bundle for Claude Desktop. Check any download against SHA256SUMS and its build attestation. The executables are not signed with a publisher certificate, so Windows SmartScreen and macOS Gatekeeper warn on first run; the standalone downloads guide explains how to proceed.

Documentation

Assets 75
Loading