mcp -office

MCP Server Office provides a set of tools to read and write Microsoft Word (docx) files via the Model Context Protocol. It exposes operations to read complete docx content (including tables and images with image placeholders), write new docx files from provided content, and perform targeted edits or insertions within existing documents. The server is accessible through standard MCP-compatible clients, and can be run via uvx as shown in the installation steps. Tools available include read_docx, write_docx, edit_docx_paragraph, and edit_docx_insert, each described in the README and designed for programmatic manipulation of docx files within a controlled MCP workflow.

Prerequisites:

• Python 3.12 or newer
• pip (comes with Python)
• Optional: uv command (via uvx) if you prefer the uvm workflow

Installation steps:

1. Create a Python virtual environment (recommended): python -m venv venv source venv/bin/activate # On Windows use: venv\Scripts\activate

2. Install the MCP server package: pip install mcp-server-office

3. Run the MCP server using uvx (recommended for MCP servers): uvx mcp-server-office

If you prefer to run directly with Python, you can use the standard Python entry point provided by the package (if available in your environment). Otherwise, the uvx command is the recommended startup method for MCP servers in this repository.

Notes and tips:

• The server requires Python 3.12+ and the dependencies mcp[cli] >= 1.2.0 and python-docx >= 1.1.2.
• Ensure the target docx files are accessible from the environment where the MCP server runs.
• For read_docx, images are represented as [Image] placeholders; image data is not embedded in the text output.
• When using edit_docx_paragraph or edit_docx_insert, provide exact paragraph indices or insertion points; updates operate on the document structure as described in the tool docs.
• If running behind a container or restricted environment, ensure proper file path access permissions for the server process.
• If you encounter issues with uvx, verify that uvx is installed and that the command resolver can locate mcp-server-office.