MCP Server Office

v1.0.0File Systemsstable

A server providing tools to read, write, and edit Microsoft Word (docx) files through the Model Context Protocol, allowing operations like complete document reading, content creation, targeted paragraph editing, and text insertion.

mcp-server-officemcpai-integration
Share:
40
Stars
0
Downloads
0
Weekly
0/5

What is MCP Server Office?

MCP Server Office is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to server providing tools to read, write, and edit microsoft word (docx) files through the model context protocol, allowing operations like complete document reading, content creation, targeted paragraph...

A server providing tools to read, write, and edit Microsoft Word (docx) files through the Model Context Protocol, allowing operations like complete document reading, content creation, targeted paragraph editing, and text insertion.

This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A server providing tools to read, write, and edit Microsoft

Use Cases

Read, write, and edit Microsoft Word documents programmatically. Create, modify, and insert text into DOCX files with full document control.
famano

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedMay 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-server-office

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCP Server Office

MCP Server Office is a Python-based MCP server that gives AI assistants the ability to read, create, and edit Microsoft Word (.docx) files through a set of focused document tools. It exposes four operations — reading full document content (including tables), writing new documents, editing existing paragraphs by index, and inserting paragraphs at specific positions — making it useful for automating report generation, contract drafting, or bulk document updates directly from an AI chat interface.

Prerequisites

  • Python 3.12 or later installed
  • uv package manager (recommended) or pip
  • An MCP-compatible client such as Claude Desktop
  • Read/write access to the .docx files you want to manipulate
1

Install mcp-server-office

Install the package using pip or uv. The uv approach is recommended as it manages a virtual environment automatically.

pip install mcp-server-office
# or with uv:
uvx mcp-server-office
2

Verify the install

Confirm the server binary is available on your PATH before wiring it into a client.

mcp-server-office --help
3

Configure Claude Desktop

Add the server to ~/Library/Application Support/Claude/claude_desktop_config.json so Claude Desktop can launch it automatically.

{
  "mcpServers": {
    "office": {
      "command": "uvx",
      "args": ["mcp-server-office"]
    }
  }
}
4

Restart Claude Desktop

Quit and reopen Claude Desktop. The office tools (read_docx, write_docx, edit_docx_paragraph, edit_docx_insert) should now appear in the available tools list.

5

Test with a sample document

Ask Claude to read an existing .docx file by providing an absolute path to verify the integration is working.

MCP Server Office Examples

Client configuration

claude_desktop_config.json snippet using uvx to run mcp-server-office.

{
  "mcpServers": {
    "office": {
      "command": "uvx",
      "args": ["mcp-server-office"]
    }
  }
}

Prompts to try

Example prompts for reading and editing Word documents through Claude.

- "Read the contents of /Users/me/Documents/report.docx"
- "Create a new Word document at /tmp/summary.docx with three paragraphs summarizing our Q1 results"
- "Edit paragraph 2 of /Users/me/contract.docx: replace 'January 1, 2025' with 'March 1, 2026'"
- "Insert a new paragraph after paragraph 5 of /Users/me/proposal.docx that says 'This section is pending legal review.'"
- "Read the table data from /Users/me/budget.docx"

Troubleshooting MCP Server Office

FileNotFoundError when reading a document

The path argument must be an absolute path to an existing .docx file. Relative paths are not resolved. Double-check the path and confirm the file exists on disk.

Images in documents appear as '[Image]' placeholders

This is expected behaviour — the read_docx tool converts embedded images to '[Image]' text. There is currently no tool to extract or render binary image content from Word files.

Table formatting is lost when writing

The write_docx tool uses a '[Table]' tag with pipe-separated cells to represent tables. Construct your content string in that format, e.g. '[Table]Header1|Header2\nCell1|Cell2', to preserve tabular structure in the output file.

Frequently Asked Questions about MCP Server Office

What is MCP Server Office?

MCP Server Office is a Model Context Protocol (MCP) server that server providing tools to read, write, and edit microsoft word (docx) files through the model context protocol, allowing operations like complete document reading, content creation, targeted paragraph editing, and text insertion. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCP Server Office?

Follow the installation instructions on the MCP Server Office GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCP Server Office?

MCP Server Office works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCP Server Office free to use?

Yes, MCP Server Office is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More File Systems MCP Servers

Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-server-office": { "command": "npx", "args": ["-y", "mcp-server-office"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use MCP Server Office?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides