Document Operations (Word, Excel, PDF)

🚀 Document Editing MCP Server for Claude Desktop

A Model Context Protocol (MCP) server that allows Claude Desktop to perform document operations on Microsoft Word, Excel, and PDF files.

🚀 Quick Start

This MCP server is designed to enable Claude Desktop to execute a variety of document - related operations on Microsoft Word, Excel, and PDF files. It offers a seamless way to work with these popular document formats within the Claude Desktop environment.

✨ Features

Microsoft Word Operations

• Create new Word documents using text.
• Edit existing Word documents (add/modify/delete paragraphs and headings).
• Convert text files (.txt) to Word documents.

Excel Operations

• Create new Excel spreadsheets from text in JSON or CSV format.
• Edit existing Excel files (update cells, ranges, add/delete rows, columns, worksheets).
• Convert CSV files to Excel.

PDF Operations

• Create new PDF files using text.
• Convert Word documents to PDF files.

📦 Installation

This MCP server requires Python 3.10 or higher.

Automatic Installation (Recommended)

Run the setup script to automatically install dependencies and configure Claude Desktop:

git clone https://github.com/alejandroBallesterosC/document-edit-mcp
cd document-edit-mcp
./setup.sh

This will:

1. Create a virtual environment.
2. Install the required dependencies.
3. Configure the server for use with Claude Desktop.
4. Create the necessary directories.

Manual Installation (if needed)

If you prefer manual installation:

1. Install the dependencies:

cd claude-document-mcp
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e .

2. Configure Claude Desktop:

Copy the claude_desktop_config.json file to:

• Mac: ~/Library/Application Support/Claude/
• Windows: %APPDATA%\Claude\

3. Restart Claude Desktop

📚 Documentation

Model Context Protocol Integration

This server adheres to the Model Context Protocol specification to provide document - processing capabilities to Claude Desktop:

• Tools: Provides manipulation functions for Word, Excel, and PDF operations.
• Resources: Provides information about the features.
• Prompts: (Not implemented yet)

💻 Usage Examples

Microsoft Word

Basic Usage

# Create a Word document
from your_module import create_word_document
filepath = 'new_doc.docx'
content = 'This is the content of the new Word document.'
result = create_word_document(filepath, content)

Advanced Usage

# Edit an existing Word document
from your_module import edit_word_document
filepath = 'existing_doc.docx'
operations = [{"type": "add_paragraph", "content": "This is a new paragraph."}]
result = edit_word_document(filepath, operations)

Excel

Basic Usage

# Create an Excel file
from your_module import create_excel_file
filepath = 'new_excel.xlsx'
content = 'col1,col2\nval1,val2'
result = create_excel_file(filepath, content)

Advanced Usage

# Edit an existing Excel file
from your_module import edit_excel_file
filepath = 'existing_excel.xlsx'
operations = [{"type": "update_cell", "cell": "A1", "value": "New Value"}]
result = edit_excel_file(filepath, operations)

PDF

Basic Usage

# Create a PDF file
from your_module import create_pdf_file
filepath = 'new_pdf.pdf'
content = 'This is the content of the new PDF file.'
result = create_pdf_file(filepath, content)

Advanced Usage

# Convert a Word document to a PDF
from your_module import convert_word_to_pdf
source_path = 'source_doc.docx'
target_path = 'target_pdf.pdf'
result = convert_word_to_pdf(source_path, target_path)

📄 API Reference

Microsoft Word

Create a Word Document

create_word_document(filepath: str, content: str) -> Dict

Edit a Word Document

edit_word_document(filepath: str, operations: List[Dict]) -> Dict

Convert TXT to Word

convert_txt_to_word(source_path: str, target_path: str) -> Dict

Excel

Create an Excel File

create_excel_file(filepath: str, content: str) -> Dict

Edit an Excel File

edit_excel_file(filepath: str, operations: List[Dict]) -> Dict

Convert CSV to Excel

convert_csv_to_excel(source_path: str, target_path: str) -> Dict

PDF

Create a PDF File

create_pdf_file(filepath: str, content: str) -> Dict

Convert Word to PDF

convert_word_to_pdf(source_path: str, target_path: str) -> Dict

🔧 Technical Details

The server logs all operations both to the console and to the logs/document_mcp.log file for easy troubleshooting.

📄 License

This project is licensed under the MIT license.

🤝 Contribution

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