What is MCP Server Office?

MCP Server Office is a server based on the Model Context Protocol (MCP) that provides tools for reading and writing Microsoft Word (docx) files. You can easily handle text, tables, and images in docx files.

How to use MCP Server Office?

First, make sure you have Python 3.12 or a higher version installed. Then install MCP Server Office via pip and start the server. You can perform file reading, writing, and editing tasks through simple command - line operations.

Applicable scenarios

MCP Server Office is very suitable for enterprises and individual users who need to batch process or automate the management of Microsoft Word documents. For example, batch generating reports, automatically inserting data into existing documents, etc.

Main features

Read docx filesRead the entire content of a docx file, including tables and images. Images will be converted to [Image] placeholders.

Create a new docx fileCreate a new docx file with specified content. Supports inserting paragraphs and tables.

Edit a specific paragraphReplace text in a specified paragraph. Each search string must match exactly once.

Insert a new paragraphInsert a new paragraph at a specified position. If no position is specified, it will be added to the end by default.

Advantages and limitations

Advantages

Easy to integrate into existing workflows

Supports a variety of complex document operations

Cross - platform compatibility

Limitations

Does not support advanced document formats (such as complex scripts)

Requires Python 3.12 or a higher version

How to use

Install MCP Server Office

Install MCP Server Office via pip: `pip install mcp - server - office`.

Start the server

Start the MCP server: `mcp - server - office`.

Perform basic operations

Use the provided commands to read, write, or edit docx files.

Usage examples

Read a docx fileUse the read_docx function to read all the content of a docx file.

Create a new docx fileUse the write_docx function to create a new docx file.

Frequently Asked Questions

Which operating systems does MCP Server Office support?

How to install MCP Server Office?

Related resources

Official documentation

Detailed usage guide and API reference.

GitHub repository

Source code and community support.

🚀 MCP Server for Office

An MCP (Model Context Protocol) server that provides read and write functions for Microsoft Word (docx) files.

🚀 Quick Start

📦 Installation

Use pip to install the package:

pip install mcp-server-office

💻 Usage

Start the MCP server:

mcp-server-office

Alternatively, run it with uv:

uvx mcp-server-office

✨ Features

Available Tools

read_docx: Read the full content of a docx file, including tables and images.
- Input: path (string) - The absolute path of the corresponding file.
- Note: Images will be converted to [Image] placeholders, and revision history will not be displayed.
write_docx: Create a new docx file with the specified content.
- Input:
  - path (string) - The absolute path of the new file.
  - content (string) - The content to be written to the file.
- Note: Use double line breaks to indicate new paragraphs, and use [Table] tags and | separators for tables.
edit_docx_paragraph: Perform text replacement in a specified paragraph of a docx file.
- Input:
  - path (string) - The path of the file to be edited.
  - edits (array) - A list of dictionaries containing search/replace information and paragraph indices.
    - paragraph_index (number) - The 0-based index of the paragraph to be modified.
    - search (string) - The text to search for in the specified paragraph.
    - replace (string) - The text to replace with.
- Note: Each search string must have a unique match within the specified paragraph.
edit_docx_insert: Insert a new paragraph into a docx file.
- Input:
  - path (string) - The path of the file to be edited.
  - inserts (array) - A list of dictionaries containing the text to be inserted and an optional paragraph index.
    - text (string) - The text to be inserted as a new paragraph.
    - paragraph_index (number, optional) - The 0-based index of the paragraph where the insertion should occur. If not specified, the text will be inserted at the end.