Office-Word-MCP-Server

A Model Context Protocol (MCP) server for creating, reading, and manipulating Microsoft Word documents. This server enables AI assistants to work with Word documents through a standardized interface, providing rich document editing capabilities.

Overview

Office-Word-MCP-Server implements the Model Context Protocol to expose Word document operations as tools and resources. It serves as a bridge between AI assistants and Microsoft Word documents, allowing for document creation, content addition, formatting, and analysis.

The server features a modular architecture that separates concerns into core functionality, tools, and utilities, making it highly maintainable and extensible for future enhancements.

Example

Pormpt

Output

Features

Document Management

• Create new Word documents with metadata

• Extract text and analyze document structure

• View document properties and statistics

• List available documents in a directory

• Create copies of existing documents

• Merge multiple documents into a single document

• Convert Word documents to PDF format

Content Creation

• Add headings with different levels

• Insert paragraphs with optional styling

• Create tables with custom data

• Add images with proportional scaling

• Insert page breaks

• Add footnotes and endnotes to documents

• Convert footnotes to endnotes

• Customize footnote and endnote styling

Rich Text Formatting

• Format specific text sections (bold, italic, underline)

• Change text color and font properties

• Apply custom styles to text elements

• Search and replace text throughout documents

Table Formatting

• Format tables with borders and styles

• Create header rows with distinct formatting

• Apply cell shading and custom borders

• Structure tables for better readability

Advanced Document Manipulation

• Delete paragraphs

• Create custom document styles

• Apply consistent formatting throughout documents

• Format specific ranges of text with detailed control

Document Protection

• Add password protection to documents

• Implement restricted editing with editable sections

• Add digital signatures to documents

• Verify document authenticity and integrity

Installation

Installing via Smithery

To install Office Word Document Server for Claude Desktop automatically via Smithery:

Prerequisites

• Python 3.8 or higher

• pip package manager

Basic Installation

Using the Setup Script

Alternatively, you can use the provided setup script which handles:

• Checking prerequisites

• Setting up a virtual environment

• Installing dependencies

• Generating MCP configuration

Usage with Claude for Desktop

Configuration

Method 1: After Local Installation

1. After installation, add the server to your Claude for Desktop configuration file:

Method 2: Without Installation (Using uvx)

1. You can also configure Claude for Desktop to use the server without local installation by using the uvx package manager:

2. Configuration file locations:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Restart Claude for Desktop to load the configuration.

Example Operations

Once configured, you can ask Claude to perform operations like:

• "Create a new document called 'report.docx' with a title page"

• "Add a heading and three paragraphs to my document"

• "Insert a 4x4 table with sales data"

• "Format the word 'important' in paragraph 2 to be bold and red"

• "Search and replace all instances of 'old term' with 'new term'"

• "Create a custom style for section headings"

• "Apply formatting to the table in my document"

API Reference

Document Creation and Properties

Content Addition

Content Extraction

Text Formatting

Table Formatting

Troubleshooting

Common Issues

1. Missing Styles

   • Some documents may lack required styles for heading and table operations

   • The server will attempt to create missing styles or use direct formatting

   • For best results, use templates with standard Word styles

2. Permission Issues

   • Ensure the server has permission to read/write to the document paths

   • Use the copy_document function to create editable copies of locked documents

   • Check file ownership and permissions if operations fail

3. Image Insertion Problems

   • Use absolute paths for image files

   • Verify image format compatibility (JPEG, PNG recommended)

   • Check image file size and permissions

Debugging

Enable detailed logging by setting the environment variable:

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository

2. Create your feature branch (git checkout -b feature/amazing-feature)

3. Commit your changes (git commit -m 'Add some amazing feature')

4. Push to the branch (git push origin feature/amazing-feature)

5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Model Context Protocol for the protocol specification

• python-docx for Word document manipulation

• FastMCP for the Python MCP implementation

Note: This server interacts with document files on your system. Always verify that requested operations are appropriate before confirming them in Claude for Desktop or other MCP clients.