mcp-office-parser

⚠️ AI-Generated Project — Use With Caution

This project was generated with the assistance of AI. While efforts have been made to verify correctness, the code may contain errors, security vulnerabilities, or unexpected behavior. It has not been fully audited or tested in production environments. Use at your own risk, and always review the source code before deploying.

An MCP (Model Context Protocol) server for reading, writing, and converting LibreOffice and Microsoft Office documents — implemented in pure JavaScript with no external binary dependencies.

Quick Start

npx @barry.wu0329/mcp-office-parser

What It Does

mcp-office-parser exposes document manipulation capabilities as MCP tools that AI assistants (like Claude) can use to:

• Read ODT, DOCX, ODP, PPTX, TXT, and more
• Read spreadsheets from ODS, XLSX, CSV files
• Create new documents (ODT, ODS, DOCX, XLSX, PDF)
• Edit existing documents by inserting text
• Convert between formats (e.g., DOCX → PDF, ODT → TXT)
• Search through documents for specific content
• Merge multiple documents into one

Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-office-parser": {
      "command": "npx",
      "args": ["@barry.wu0329/mcp-office-parser"]
    }
  }
}

VS Code (MCP extension)

Add to .vscode/mcp.json:

{
  "servers": {
    "mcp-office-parser": {
      "command": "npx",
      "args": ["@barry.wu0329/mcp-office-parser"]
    }
  }
}

Supported File Formats

| Format | Read | Write | Notes | |--------|------|-------|-------| | .odt | ✅ | ✅ | LibreOffice Writer | | .ods | ✅ | ✅ | LibreOffice Calc | | .odp | ✅ | ✅ | LibreOffice Impress | | .docx | ✅ | ✅ | Microsoft Word | | .xlsx | ✅ | ✅ | Microsoft Excel | | .pptx | ✅ | — | Microsoft PowerPoint | | .txt | ✅ | ✅ | Plain text | | .csv | ✅ | ✅ | Comma-separated values | | .pdf | ✅ | ✅ | Read via pdf-parse; write via pdf-lib | | .html | — | ✅ | HTML conversion output |

Available MCP Tools

| Tool | Description | |------|-------------| | get_document_info | Get file metadata (size, format, modified time) | | read_document_text | Extract plain text from a document | | read_spreadsheet_data | Read spreadsheet data as a 2D array | | create_document | Create a new document with content | | insert_text_at_position | Insert text at start, end, or replace content | | list_documents | Find all supported documents in a directory | | search_documents | Search document contents for a query string | | get_document_statistics | Word count, character count, sentence count, etc. | | convert_document | Convert between formats | | merge_text_documents | Merge multiple documents into one |

MCP Resources

• documents:// — Lists all discoverable documents as JSON
• document://{path} — Reads a document's text content

Requirements

• Node.js >= 18.17.0
• No LibreOffice or other external tools needed

License

MIT