Word Document MCP Server

A powerful Model Context Protocol (MCP) server for Word document operations with dynamic C# code execution capabilities.

Features

📄 Word Document Operations

• Create Documents: Create new Word documents with optional titles
• Read Documents: Extract text content from existing documents
• Append Content: Add new content to existing documents
• Update Content: Find and replace text in documents
• Formatted Content: Add text with bold, italic, font sizes, and heading styles
• Tables: Insert tables with specified dimensions
• Document Info: Get metadata (word count, paragraphs, file size, etc.)

💻 Dynamic Code Execution

• Execute C# Code: Run arbitrary C# code with standard library access
• Custom Word Operations: Execute C# code with direct access to WordprocessingDocument for complex operations

Installation

1. Build the project:

   dotnet build
   

2. Run the server:

   dotnet run
   

3. Test all tools (optional):

   dotnet run -- --test
   

   This will create a test_document.docx file demonstrating all available tools.

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "word-doc-server": {
      "command": "dotnet",
      "args": ["run", "--project", "C:\\path\\to\\WordDoc_MCP\\WordDoc_MCP.csproj"]
    }
  }
}

Or using a published executable:

{
  "mcpServers": {
    "word-doc-server": {
      "command": "C:\\path\\to\\WordDoc_MCP.exe"
    }
  }
}

VS Code / Continue

Add to your MCP configuration:

{
  "servers": {
    "word-doc-server": {
      "command": "dotnet",
      "args": ["C:\\path\\to\\WordDoc_MCP.dll"]
    }
  }
}

Available Tools

Basic Operations

create_word_document

Create a new Word document with specified content.

Parameters:

• filePath (string): Path where the document will be created
• content (string): Text content to add
• title (string, optional): Document title

Example:

Create a Word document at "report.docx" with title "Annual Report" and content "This is the introduction."

read_word_document

Read content from an existing Word document.

Parameters:

• filePath (string): Path to the document

append_to_word_document

Append content to an existing Word document.

Parameters:

• filePath (string): Path to the document
• content (string): Text to append

update_word_document

Find and replace text in a Word document.

Parameters:

• filePath (string): Path to the document
• searchText (string): Text to find
• replaceText (string): Replacement text

Formatting

add_formatted_content

Add formatted content with various styling options.

Parameters:

• filePath (string): Path to the document
• content (string): Content to add
• bold (boolean, optional): Make text bold
• italic (boolean, optional): Make text italic
• fontSize (integer, optional): Font size in points (default: 11)
• heading (integer, optional): Heading level 1-6, 0 for normal text

Example:

Add "Executive Summary" to report.docx as Heading 1 with bold formatting

add_table

Add a table to a Word document.

Parameters:

• filePath (string): Path to the document
• rows (integer): Number of rows
• columns (integer): Number of columns
• data (string, optional): Table data as JSON array

Example:

Add a 3x4 table to report.docx

Information

get_document_info

Get metadata and statistics about a document.

Parameters:

• filePath (string): Path to the document

Dynamic Code Execution

execute_code

Execute C# code dynamically.

Parameters:

• code (string): C# code to execute
• returnResult (boolean, optional): Return execution result (default: true)

Example:

execute_code(code: "DateTime.Now.AddDays(7).ToString(\"yyyy-MM-dd\")"

... [View full README on GitHub](https://github.com/keerukee/word_doc_MCP_Server#readme)