Skip to main content
Glama

MCP Server Office

Smithery badge

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)

Smithery badge

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

Available Tools

4 tools
edit_docx_insertA

Insert new paragraphs into a docx file. Accepts a list of inserts with text and optional paragraph index. Each insert creates a new paragraph at the specified position. If paragraph_index is not specified, the paragraph is added at the end. When multiple inserts target the same paragraph_index, they are inserted in order. Returns a git-style diff showing the changes made.

Inputs: path (required), inserts (required).

edit_docx_paragraphA

Make text replacements in specified paragraphs of a docx file. Accepts a list of edits with paragraph index and search/replace pairs. Each edit operates on a single paragraph and preserves the formatting of the first run. Returns a git-style diff showing the changes made. Only works within allowed directories.

Inputs: path (required), edits (required).

read_docxA

Read complete contents of a docx file including tables and images.Use this tool when you want to read file endswith '.docx'.Paragraphs are separated with two line breaks.This tool convert images into placeholder [Image].'--- Paragraph [number] ---' is indicator of each paragraph.

Inputs: path (required).

write_docxA

Create a new docx file with given content.Editing exisiting docx file with this tool is not recomended.

Inputs: path (required), content (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 4 tools

    Disambiguation4/5

    The tools are mostly distinct: read_docx for reading, write_docx for creation, and two edit tools for modifications. However, edit_docx_insert and edit_docx_paragraph could be confused as both handle docx editing with paragraph indices, though their specific purposes (inserting vs. replacing text) are clarified in descriptions.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with underscores, using clear verbs like read, write, and edit. The naming is predictable and uniform across all four tools, making them easy to distinguish and use.

    Tool Count5/5

    With 4 tools, this server is well-scoped for basic docx file operations, covering reading, writing, and editing. Each tool has a clear purpose, and the count is appropriate for the domain without being too sparse or bloated.

    Completeness4/5

    The tool set provides good coverage for docx file handling, including read, write, and edit functions. A minor gap exists in editing tables or images, as the tools focus on text paragraphs, but core workflows are adequately supported for typical document tasks.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      A comprehensive Model Context Protocol server that processes Microsoft Word documents with full formatting support, enabling text extraction, HTML/Markdown conversion, structure analysis, and image extraction.
      5
      2
      -
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      A Python server implementing Model Context Protocol for advanced Microsoft Word document manipulation, enabling programmatic automation of complex document processing tasks.
      -
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server for reading, editing, and validating Microsoft Word documents with specialized support for track changes, comments, and footnotes. It enables structural auditing, heading extraction, and precise OOXML-level document manipulation through natural language tools.
      10
      100
      1,057 PyPI
      69
      MIT