MCP Server Office

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

Usage

Install with pip:

Then, start the MCP server:

Or using uv, just:

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.

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.

How to use

Install using pip:

Start the MCP server:

Or, using uv:

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