OfficeAgent.NET
Edit Word, PowerPoint and Excel files and fill company templates without breaking them
- Pricing
- Open source
- Platforms
- Windows, macOS, Linux
- Runs
- Locally
- Version
- 1.3.0
- Listing updated
- today
Similar MCP servers
About OfficeAgent.NET
OfficeAgent.NET is an open-source MCP server for files and documents. It runs locally on your machine and is started by your AI client.
OfficeAgent.NET handles the XML plumbing of Office files so an agent works with structured data and typed operations instead of raw markup. Each change is a plan that is previewed first, and if any check fails nothing is written. It is built on Microsoft's Open XML SDK and runs without Office installed.
Its Word work includes filling a company template through content controls, bookmarks and repeating table rows while keeping styles, numbering, headers and comments, changing clauses, prices or dates as real tracked changes, managing comments and comparing documents to produce a redline plan. For PowerPoint it builds slides on a template's own layouts with named shapes, tables, native charts and pictures. For Excel it inspects sheets and ranges, sets cells and formulas and appends table rows, and it can refresh a report's numbers and charts from a workbook.
It can read documents from bounded filesystem roots, SharePoint, iManage Work, Google Drive, Box, Azure Blob Storage and Amazon S3. Applying a plan produces SHA-256 receipts, creating files is off unless you enable create_document, and one plan can apply to up to 100 documents. The same engine is also available as a .NET library and as tools for Microsoft Agent Framework.
Install
Run in a terminal
claude mcp add officeagent -- docker run -i --rm ghcr.io/ilia-sokolov/officeagent-mcp:1.3.0Add to claude_desktop_config.json
{
"mcpServers": {
"officeagent": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ilia-sokolov/officeagent-mcp:1.3.0"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"officeagent": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ilia-sokolov/officeagent-mcp:1.3.0"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"officeagent": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ilia-sokolov/officeagent-mcp:1.3.0"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"officeagent": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ilia-sokolov/officeagent-mcp:1.3.0"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"officeagent": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ilia-sokolov/officeagent-mcp:1.3.0"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
OfficeAgent__FileSystemConnections__0__ConnectionIdConnection id the agent uses to address documents on the filesystem (any non-empty string). Optional: with nothing configured the server starts with an in-memory session connection whose documents last only while it runs. Set this and RootPath to edit documents on disk instead; SharePoint is OfficeAgent__SharePointConnections__0__*OfficeAgent__FileSystemConnections__0__RootPathAbsolute path to the directory this filesystem connection may read and write documents under. Only .docx is allowed unless OfficeAgent__FileSystemConnections__0__AllowedExtensions__N adds more (.pptx for decks or .xlsx for workbooks). Deck connections usually want OfficeAgent__FileSystemConnections__0__DefaultChangeMode=Direct because PowerPoint cannot record tracked changesOfficeAgent__AllowCreationSet to true to expose create_document, so an agent can author a new file in the connection rather than only editing existing ones. Off by default: creating agent-named files under a connection root is a capability the host should choose deliberatelyOfficeAgent__FileSystemConnections__0__ConnectionIdConnection id the agent uses to address documents.OfficeAgent__FileSystemConnections__0__RootPathFolder inside the container to read and edit; mount yours there.
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- create_document
- Create a new document in a connection; disabled unless AllowCreation is set.
What it does
- Template filling
- Fill Word content controls, bookmarks and repeating rows while keeping the template's styling.
- Tracked changes
- Record clause, price and date edits as revisions Word can accept or reject.
- PowerPoint on templates
- Build slides on a template's own layouts with tables, charts and pictures.
- Excel editing
- Inspect ranges, set cells and formulas, and append table rows.
- Preview before apply
- Typed plans are checked first and nothing is written if a check fails.
- Many storage backends
- Filesystem, SharePoint, iManage, Google Drive, Box, Azure Blob and S3.
- Bulk edits
- Apply one plan to up to 100 documents with a receipt per output.
Good for
- Fill a quote template from CRM data
- Change contract clauses as tracked changes for review
- Build a deck on the company PowerPoint template
- Refresh a monthly report's numbers from an Excel workbook
- Translate a paragraph and keep its formatting
Pricing
Open source
Open source; NuGet, PyPI wrapper, MCPB bundle and container image
OfficeAgent.NET FAQ
Does it need Microsoft Office?
No. It is built on the Open XML SDK and runs without Office installed.
How do I run it without .NET?
Use uvx officeagent-mcp --stdio pointed at a folder, or the one-click bundle for Claude Desktop.
Can it create new files?
Only if you set OfficeAgent__AllowCreation to true, which exposes create_document.
What formats does it support?
Word .docx, PowerPoint .pptx and Excel .xlsx.
Is OfficeAgent.NET free?
Yes. OfficeAgent.NET is open source, so you can use and self-host it for free.
How do I add OfficeAgent.NET to Claude Code?
Run this command in your terminal: claude mcp add officeagent -- docker run -i --rm ghcr.io/ilia-sokolov/officeagent-mcp:1.3.0
What are the best alternatives to OfficeAgent.NET?
The closest alternatives to OfficeAgent.NET are Ha MCP, Concord MCP, note1, SSRS2 and Csv.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
