MCP Documents

Unified MCP Server for Document Processing

A comprehensive Model Context Protocol (MCP) server that combines the best features from multiple document processing libraries into a single, efficient Python 3.10 compatible engine.

Features

📄 Word Document Operations (DOCX)

• Create/Open/Save - Full document lifecycle management

• Content - Paragraphs, headings, tables, images

• Formatting - Font styles, colors, alignment, spacing

• Tables - Create, edit, merge cells, add/delete rows

• Sections - Page layout, margins, orientation

• Headers/Footers - Add, modify, zone-based headers

• Styles - Built-in and custom styles management

• Search/Replace - Find and replace with preview

🔄 Format Conversion

• DOCX ↔ PDF - Bidirectional conversion

• Markdown → DOCX/PDF - With styling support

• Markdown → PPTX - PowerPoint presentations

• Image formats - PNG, JPG, WebP, GIF, BMP, TIFF

• Excel → CSV - Spreadsheet conversion

• HTML → PDF - Web page to document

🎨 Advanced Features

• Template support - Reference documents for styling

• Pandoc integration - Advanced format conversion

• Base64 I/O - Direct content handling without files

• Batch operations - Multiple edits in one call

Related MCP server: MCP-OPENAPI-DOCX

Installation

cd MCP-Documents
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

Optional Dependencies

For PDF conversion:

pip install -e ".[pdf]"

For all features:

pip install -e ".[full]"

External Tools

Some features require external tools:

• Pandoc - For advanced format conversion: sudo apt install pandoc

• LibreOffice - For DOCX→PDF on Linux: sudo apt install libreoffice

• wkhtmltopdf - For HTML→PDF: sudo apt install wkhtmltopdf

Configuration

Claude Desktop / VS Code

Add to your MCP configuration:

{
  "mcpServers": {
    "mcp-documents": {
      "command": "/path/to/MCP-Documents/.venv/bin/python",
      "args": ["-m", "mcp_documents.server"]
    }
  }
}

Usage Examples

Create a Document

"Create a new Word document called report.docx with title 'Q4 Report'"

Add Content

"Add a heading 'Summary' at level 2, then add a paragraph with the quarterly results"

Format Text

"Make the title bold and center-aligned, set font size to 24pt"

Add Tables

"Insert a 3x4 table with sales data, merge the header row"

Convert Formats

"Convert report.docx to PDF"
"Convert this markdown to PowerPoint and save as presentation.pptx"

Available Tools

Document Management

Content Operations

Table Operations

Format Conversion

Search & Edit

Architecture

mcp_documents/
├── __init__.py          # Package exports
├── server.py            # MCP server entry point
├── core/
│   ├── document.py      # Document processor class
│   ├── formatting.py    # Text/paragraph formatting
│   └── utils.py         # Helper functions
├── tools/
│   ├── document_ops.py  # Document CRUD operations
│   ├── content_ops.py   # Content manipulation
│   ├── table_ops.py     # Table operations
│   ├── style_ops.py     # Style management
│   ├── section_ops.py   # Section/layout operations
│   ├── header_footer.py # Headers and footers
│   └── conversion.py    # Format conversion tools
└── converters/
    ├── pdf.py           # PDF conversion
    ├── image.py         # Image conversion
    └── pandoc.py        # Pandoc wrapper

License

MIT License