Enables Amazon Q Developer to create, read, manipulate, and analyze Microsoft Word documents programmatically through the Office-Word-MCP server.
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., "@Office-Word-MCP Create a new Word document with a heading"
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.
Enterprise-Grade Document Automation Protocol for Amazon Q & Kiro
Office-Word-MCP is a robust Model Context Protocol (MCP) server designed to enable advanced document processing capabilities for AI assistants like Amazon Q Developer, Kiro, and other MCP-compliant clients.
It provides a standardized interface for AI agents to programmatic create, read, manipulate, and analyze Microsoft Word documents (.docx). By abstracting complex document object models into clean API tools, it empowers AI assistants to generate professional reports, contracts, and documentation workflows autonomously.
Seamless Integration: Optimized for Amazon Q and Kiro environments.
Rich Formatting: Support for complex tables, styling, and layout controls.
Enterprise Ready: Includes document protection, comment analysis, and structured data handling.
Secure: Runs locally with explicit permission controls.
Related MCP server: Claude Document MCP Server
Lifecycle Control: Create, copy, merge, and convert documents (to PDF).
Structure Analysis: Extract outlines, metadata, and statistics.
Security: Apply password protection and manage restricted editing.
Advanced Tables: Create complex layouts with merges, shading, and custom borders.
Rich Text: precision control over fonts, colors, and paragraph styles.
Media: Insert images with proportional scaling.
Dynamic Lists: XML-compliant bulleted and numbered lists.
Comment Mining: Extract and filter comments by author or content.
Track Changes: (Future roadmap) Support for revision tracking.
Python 3.10 or higher
uv (recommended) or pip package manager
uvx (Recommended for ephemeral use)No installation required. You can run the server directly using uvx.
uvx --from office-word-mcp-server word_mcp_serverClone the repository and install dependencies:
git clone https://github.com/GongRzhe/Office-Word-MCP-Server.git
cd Office-Word-MCP-Server
pip install -r requirements.txtTo integrate Office-Word-MCP with Amazon Q Developer:
Open your IDE settings and navigate to Amazon Q > MCP Servers.
Add a new server configuration:
Name: word-automation
Command: uvx
Args: --from, office-word-mcp-server, word_mcp_server
Restart your IDE. Amazon Q will now have access to Word tools.
Configure the server in your Kiro settings or configuration file:
{
"mcpServers": {
"office-word": {
"command": "uvx",
"args": ["--from", "office-word-mcp-server", "word_mcp_server"]
}
}
}Add the following to your MCP configuration file (e.g., claude_desktop_config.json):
{
"mcpServers": {
"word-server": {
"command": "uvx",
"args": ["--from", "office-word-mcp-server", "word_mcp_server"]
}
}
}The server exposes the following tools to the AI assistant.
Tool Name | Description |
| Create a new blank or template-based document. |
| Extract all text content from a file. |
| Scan directory for valid Word files. |
| Export .docx to PDF format. |
Tool Name | Description |
| Insert structured headings (Levels 1-9). |
| Add text blocks with style support. |
| Create a new table structure. |
| Apply bold, italic, color, etc., to text ranges. |
Tool Name | Description |
| Apply styles, borders, and shading to tables. |
| Merge cells horizontally or vertically. |
| Precise control over column dimensions. |
(See full tool list in word_mcp_server.py source)
Permission Denied
Cause: The server cannot access the file system.
Fix: Ensure the running process has R/W access to the target directory. On Windows, ensure the file isn't open in Microsoft Word.
Styling Not Applied
Cause: Using a style name that doesn't exist in the base template.
Fix: Use create_custom_style to define the style before using it, or use standard Word styles (e.g., "Normal", "Heading 1").
Image Insertion Failures
Cause: Relative paths may be ambiguous.
Fix: Always use absolute paths for images.
Set the MCP_DEBUG environment variable to 1 to enable verbose logging:
# Windows (PowerShell)
$env:MCP_DEBUG = "1"This project is licensed under the MIT License. See LICENSE for details.
Built for the Agentic Era.
Add an endnote to a specific paragraph in a Word document.
Inputs: filename (required), paragraph_index (required), endnote_text (required).
Add a footnote after specific text with proper superscript formatting. This enhanced function ensures footnotes display correctly as superscript.
Inputs: filename (required), search_text (required), footnote_text (required), output_filename.
Add a footnote before specific text with proper superscript formatting. This enhanced function ensures footnotes display correctly as superscript.
Inputs: filename (required), search_text (required), footnote_text (required), output_filename.
Enhanced footnote addition with guaranteed superscript formatting. Adds footnote at the end of a specific paragraph with proper style handling.
Inputs: filename (required), paragraph_index (required), footnote_text (required), output_filename.
Add footnote with robust validation and Word compliance. This is the production-ready version with comprehensive error handling.
Inputs: filename (required), search_text, paragraph_index, footnote_text, +2 more.
Add a footnote to a specific paragraph in a Word document.
Inputs: filename (required), paragraph_index (required), footnote_text (required).
Add a heading to a Word document with optional formatting.
Inputs: filename (required), text (required), level, font_name, +4 more.
Add a page break to the document.
Inputs: filename (required).
Add a paragraph to a Word document with optional formatting.
Inputs: filename (required), text (required), style, font_name, +4 more.
Add an image to a Word document.
Inputs: filename (required), image_path (required), width.
Add a table to a Word document.
Inputs: filename (required), rows (required), cols (required), data.
Apply alternating row colors to a table for better readability.
Inputs: filename (required), table_index (required), color1, color2.
Set table columns to auto-fit based on content.
Inputs: filename (required), table_index (required).
Convert a Word document to PDF format.
Inputs: filename (required), output_filename.
Create a copy of a Word document.
Inputs: source_filename (required), destination_filename.
Create a custom style in the document.
Inputs: filename (required), style_name (required), bold, italic, +4 more.
Create a new Word document with optional metadata.
Inputs: filename (required), title, author.
Customize footnote numbering and formatting in a Word document.
Inputs: filename (required), numbering_format, start_number, font_name, +1 more.
Delete a footnote from a Word document. Identify the footnote either by ID (1, 2, 3, etc.) or by searching for text near it.
Inputs: filename (required), footnote_id, search_text, output_filename.
Delete footnote with comprehensive cleanup and orphan removal. Ensures complete removal from document.xml, footnotes.xml, and relationships.
Inputs: filename (required), footnote_id, search_text, clean_orphans.
Delete a paragraph from a document.
Inputs: filename (required), paragraph_index (required).
Find occurrences of specific text in a Word document.
Inputs: filename (required), text_to_find (required), match_case, whole_word.
Format a table with borders, shading, and structure.
Inputs: filename (required), table_index (required), has_header_row, border_style, +1 more.
Format text within a specific table cell.
Inputs: filename (required), table_index (required), row_index (required), col_index (required), +7 more.
Format a specific range of text within a paragraph.
Inputs: filename (required), paragraph_index (required), start_pos (required), end_pos (required), +6 more.
Extract all comments from a Word document.
Inputs: filename (required).
Extract comments from a specific author in a Word document.
Inputs: filename (required), author (required).
Extract comments for a specific paragraph in a Word document.
Inputs: filename (required), paragraph_index (required).
Get information about a Word document.
Inputs: filename (required).
Get the structure of a Word document.
Inputs: filename (required).
Extract all text from a Word document.
Inputs: filename (required).
Get the raw XML structure of a Word document.
Inputs: filename (required).
Get text from a specific paragraph in a Word document.
Inputs: filename (required), paragraph_index (required).
Apply special highlighting to table header row.
Inputs: filename (required), table_index (required), header_color, text_color.
Insert a header (with specified style) before or after the target paragraph. Specify by text or paragraph index. Args: filename (str), target_text (str, optional), header_title (str), position ('before' or 'after'), header_style (str, default 'Heading 1'), target_paragraph_index (int, optional).
Inputs: filename (required), target_text, header_title, position, +2 more.
Insert a new line or paragraph (with specified or matched style) before or after the target paragraph. Specify by text or paragraph index. Args: filename (str), target_text (str, optional), line_text (str), position ('before' or 'after'), line_style (str, optional), target_paragraph_index (int, optional).
Inputs: filename (required), target_text, line_text, position, +2 more.
Insert a bulleted or numbered list before or after the target paragraph. Specify by text or paragraph index. Args: filename (str), target_text (str, optional), list_items (list of str), position ('before' or 'after'), target_paragraph_index (int, optional), bullet_type ('bullet' for bullets or 'number' for numbered lists, default: 'bullet').
Inputs: filename (required), target_text, list_items, position, +2 more.
List all .docx files in the specified directory.
Inputs: directory.
Merge cells in a rectangular area of a table.
Inputs: filename (required), table_index (required), start_row (required), start_col (required), +2 more.
Merge cells horizontally in a single row.
Inputs: filename (required), table_index (required), row_index (required), start_col (required), +1 more.
Merge cells vertically in a single column.
Inputs: filename (required), table_index (required), col_index (required), start_row (required), +1 more.
Add password protection to a Word document.
Inputs: filename (required), password (required).
Replace all content between start_anchor_text and end_anchor_text (or next logical header if not provided).
Inputs: filename (required), start_anchor_text (required), new_paragraphs (required), end_anchor_text, +2 more.
Reemplaza el bloque de párrafos debajo de un encabezado, evitando modificar TOC.
Inputs: filename (required), header_text (required), new_paragraphs (required), detect_block_end_fn.
Search for text and replace all occurrences.
Inputs: filename (required), find_text (required), replace_text (required).
Set text alignment for all cells in a table.
Inputs: filename (required), table_index (required), horizontal, vertical.
Set text alignment for a specific table cell.
Inputs: filename (required), table_index (required), row_index (required), col_index (required), +2 more.
Set padding/margins for a specific table cell.
Inputs: filename (required), table_index (required), row_index (required), col_index (required), +5 more.
Apply shading/filling to a specific table cell.
Inputs: filename (required), table_index (required), row_index (required), col_index (required), +2 more.
Set the width of a specific table column.
Inputs: filename (required), table_index (required), col_index (required), width (required), +1 more.
Set the widths of multiple table columns.
Inputs: filename (required), table_index (required), widths (required), width_type.
Set the overall width of a table.
Inputs: filename (required), table_index (required), width (required), width_type.
Remove password protection from a Word document.
Inputs: filename (required), password (required).
Validate all footnotes in document for coherence and compliance. Returns detailed report on ID conflicts, orphaned content, missing styles, etc.
Inputs: filename (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 54 tools
Multiple footnote tools (e.g., add_footnote_enhanced, add_footnote_robust) have overlapping purposes, causing confusion. Similarly, there are many very similar table manipulation tools. The boundaries between tools are often unclear.
Overall follows verb_noun pattern but with inconsistencies like 'add_footnote_enhanced' vs 'add_footnote_to_document' and 'delete_footnote_robust'. Some tools use vague suffixes like '_robust' that break consistency.
54 tools is excessive for a Word document server. Many tools are redundant (e.g., 5+ footnote adding methods) and could be consolidated. The count suggests poor scoping and duplication.
Covers basic CRUD, text manipulation, tables, footnotes, comments, and protection. However, lacks common features like track changes, mail merge, headers/footers (document headers), and more advanced layout options.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Convert, create and edit Word, PowerPoint, Excel and PDF documents from any AI agent.
A Model Context Protocol server for Wix AI tools
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
