MCP Server Office

A Model Context Protocol (MCP) server providing tools to read/write Microsoft Word (docx) files.

Installing via Smithery

To install Server Office for Claude Desktop automatically via Smithery :

npx -y @smithery/cli install @famano/mcp-server-office --client claude

Usage

Install with pip:

pip install mcp-server-office

Then, start the MCP server:

mcp-server-office

Or using uv, just:

uvx mcp-server-office

Available Tools

1. read_docx : Read complete contents of a docx file including tables and images.

   • Input: path (string) - Absolute path to the target file

   • Note: Images are converted to [Image] placeholders, and track changes are not shown

2. write_docx : Create a new docx file with given content.

   • Input:

     • path (string) - Absolute path to target file

     • content (string) - Content to write to the file

   • Note: Use double line breaks for new paragraphs, and [Table] tag with | separators for tables

3. edit_docx_paragraph : Make text replacements in specified paragraphs of a docx file.

   • Input:

     • path (string) - Absolute path to file to edit

     • edits (array) - List of dictionaries containing search/replace text and paragraph index

       • paragraph_index (number) - 0-based index of the paragraph to edit

       • search (string) - Text to find within the specified paragraph

       • replace (string) - Text to replace with

   • Note: Each search string must match exactly once within the specified paragraph

4. edit_docx_insert : Insert new paragraphs into a docx file.

   • Input:

     • path (string) - Absolute path to file to edit

     • inserts (array) - List of dictionaries containing text and optional paragraph index

       • text (string) - Text to insert as a new paragraph

       • paragraph_index (number, optional) - 0-based index of the paragraph before which to insert. If not specified, insert at the end.

Related MCP server: DOCX MCP Server

Requirements

• Python >= 3.12

• Dependencies:

  • mcp[cli] >= 1.2.0

  • python-docx >= 1.1.2

MCP Server Office (Japanese)

A Model Context Protocol (MCP) server that provides reading and writing Microsoft Word (docx) files.

Installation by Smithery

To automatically install Server Office on Claude Desktop via Smithery :

npx -y @smithery/cli install @famano/mcp-server-office --client claude

How to use

Install using pip:

pip install mcp-server-office

Start the MCP server:

mcp-server-office

Or, using uv:

uvx mcp-server-office

Available Tools

1. read_docx : Reads the complete content of a docx file, including tables and images.

   • Input: path (string) - absolute path of the target file

   • Note: Images are converted to a placeholder called [Image] and revision history is not displayed.

2. write_docx : Creates a new docx file with the specified content.

   • input:

     • path (string) - The absolute path of the file to create.

     • content (string) - the content to write to the file

   • Note: Paragraphs are separated by two line breaks, tables use the [Table] tag and | separator

3. edit_docx_paragraph : Replaces the text of a specified paragraph in a docx file.

   • input:

     • path (string) - The absolute path of the file to edit.

     • edits (array) - List of dictionaries containing search/replace text and paragraph indexes

       • paragraph_index (number) – the 0-based index of the paragraph to edit.

       • search (string) – The text to search for in the specified paragraph.

       • replace (string) – The replacement text.

   • Note: Each search string must match exactly once in a given paragraph.

4. edit_docx_insert : Inserts a new paragraph into a docx file.

   • input:

     • path (string) - The absolute path of the file to edit.

     • inserts (array) - A list of dictionaries containing the text and optional paragraph indexes.

       • text (string) – the text to insert as a new paragraph

       • paragraph_index (number, optional) - 0-based index of the paragraph to insert at. If not specified it will insert at the end.

Requirements

• Python >= 3.12

• Dependent packages:

  • mcp[cli] >= 1.2.0

  • python-docx >= 1.1.2