MCP Server Office
The MCP Server Office is a server providing tools to interact with Microsoft Word (docx) files:
Read DOCX Files: Retrieve complete contents of docx files, including tables and images (converted to [Image] placeholders).
Write DOCX Files: Create new docx files with specified content, using double line breaks for paragraphs and [Table] tags with | separators for tables.
Edit Paragraphs: Replace specific text within paragraphs while preserving formatting.
Insert Paragraphs: Add new paragraphs at specified positions (using 0-based index) or at the end of a file.
Works with Absolute Paths: Operations require absolute paths to target files.
Allows reading, writing, and editing Microsoft Word (docx) files, including parsing tables and images, making text replacements in specific paragraphs, and inserting new paragraphs at specified positions.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Server Office read the quarterly report at /Users/alice/Documents/report.docx"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 claudeUsage
Install with pip:
pip install mcp-server-officeThen, start the MCP server:
mcp-server-officeOr using uv, just:
uvx mcp-server-officeAvailable Tools
read_docx: Read complete contents of a docx file including tables and images.Input:
path(string) - Absolute path to the target fileNote: Images are converted to [Image] placeholders, and track changes are not shown
write_docx: Create a new docx file with given content.Input:
path(string) - Absolute path to target filecontent(string) - Content to write to the file
Note: Use double line breaks for new paragraphs, and [Table] tag with | separators for tables
edit_docx_paragraph: Make text replacements in specified paragraphs of a docx file.Input:
path(string) - Absolute path to file to editedits(array) - List of dictionaries containing search/replace text and paragraph indexparagraph_index(number) - 0-based index of the paragraph to editsearch(string) - Text to find within the specified paragraphreplace(string) - Text to replace with
Note: Each search string must match exactly once within the specified paragraph
edit_docx_insert: Insert new paragraphs into a docx file.Input:
path(string) - Absolute path to file to editinserts(array) - List of dictionaries containing text and optional paragraph indextext(string) - Text to insert as a new paragraphparagraph_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 claudeHow to use
Install using pip:
pip install mcp-server-officeStart the MCP server:
mcp-server-officeOr, using uv:
uvx mcp-server-officeAvailable Tools
read_docx: Reads the complete content of a docx file, including tables and images.Input:
path(string) - absolute path of the target fileNote: Images are converted to a placeholder called [Image] and revision history is not displayed.
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
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 indexesparagraph_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.
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 paragraphparagraph_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 toolsedit_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
Scored across 4 tools
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.
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.
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.
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
Related MCP Connectors
Convert, create and edit Word, PowerPoint, Excel and PDF documents from any AI agent.
Document editing, AI writing, saved documents, DOCX downloads, PDF, STT, TTS and watermarking
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
Create Word .docx files from sections or markdown, fill templates, and read text from a .docx.
Related MCP Servers
- AlicenseCqualityFmaintenanceA Model Context Protocol server that enables AI assistants to create, read, edit, and format Microsoft Word documents through standardized tools and resources.5417,825 PyPI2,116MIT
- FlicenseAqualityDmaintenanceA 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.52-
- -licenseNot gradedqualityNot gradedmaintenanceA Python server implementing Model Context Protocol for advanced Microsoft Word document manipulation, enabling programmatic automation of complex document processing tasks.-
- AlicenseBqualityDmaintenanceAn 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.101001,057 PyPI69MIT