# OfficeAgent.NET

> OfficeAgent.NET is an open-source MCP server for files and documents. Edit Word, PowerPoint and Excel files and fill company templates without breaking them. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, macOS, Linux, CLI, self-hosted
- **Repository:** https://github.com/ilia-sokolov/officeagent.net
- **MCP Registry name:** io.github.ilia-sokolov/officeagent
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add officeagent -- docker run -i --rm ghcr.io/ilia-sokolov/officeagent-mcp:1.3.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "officeagent": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ilia-sokolov/officeagent-mcp:1.3.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "officeagent": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ilia-sokolov/officeagent-mcp:1.3.0"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "officeagent": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ilia-sokolov/officeagent-mcp:1.3.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "officeagent": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ilia-sokolov/officeagent-mcp:1.3.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "officeagent": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/ilia-sokolov/officeagent-mcp:1.3.0"
      ]
    }
  }
}
```

## Tools

- `create_document`: Create a new document in a connection; disabled unless AllowCreation is set.

## 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.

## 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.
- [SSRS2](https://ai-powered.com/mcp/ssrs2): SSRS2 is an MCP server for files and documents.
- [Csv](https://ai-powered.com/mcp/csv): Csv is a freemium MCP server for files and documents.
- [Zovo Spreadsheet Compare](https://ai-powered.com/mcp/zovo-spreadsheet-compare): Zovo Spreadsheet Compare is an MCP server for files and documents.
- [Jira](https://ai-powered.com/mcp/jira): Jira is a freemium MCP server for productivity.
- [InviteKit Calendar Files](https://ai-powered.com/mcp/invitekit-calendar-files): InviteKit Calendar Files is an MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/officeagent-net
