LibreOffice MCP Server

A Model Context Protocol (MCP) server for LibreOffice document operations, built in Go.

Features

Core Capabilities

• Document Operations: Create, read, edit, and convert LibreOffice documents
• Multi-Format Support: Writer (ODT, DOC, DOCX), Calc (ODS, XLS, XLSX), Impress (ODP, PPT, PPTX), PDF
• Text Extraction: Extract plain text from any supported document format
• Document Conversion: Convert between formats with LibreOffice's conversion engine
• Spreadsheet Reading: Read and parse spreadsheet data to CSV
• Text Insertion: Insert text into Writer documents at specific positions
• Document Statistics: Get word count, character count, and metadata
• Search: Search for text across multiple documents
• Batch Operations: Convert multiple documents in one operation
• Document Merging: Merge multiple text documents into one

Architecture

• Execution Tracking: Unique execution IDs for every operation with output management
• Worker Pool: Configurable concurrent execution with semaphore-based control
• TTL-based Cleanup: Automatic cleanup of temporary files and outputs
• Security: Path validation, format whitelisting, and optional malware scanning
• Dual Transport: Support for stdio and HTTP transports
• File Upload: HTTP-based file upload with upload:// URI resolution
• Malware Scanning: Optional ClamAV integration for uploaded files

Prerequisites

• Go: 1.24 or later
• LibreOffice: 24.2 or later (24.8+ recommended)
  • macOS: brew install libreoffice
  • Ubuntu/Debian: sudo apt install libreoffice
  • Fedora/RHEL: sudo dnf install libreoffice
• ClamAV (optional, for malware scanning):
  • macOS: brew install clamav
  • Ubuntu/Debian: sudo apt install clamav clamav-daemon

Quick Start

Installation

# Clone the repository
git clone https://github.com/sagacient/libreoffice-mcp-server.git
cd libreoffice-mcp-server

# Build
go build -o libreoffice-mcp-server .

# Or install globally
go install .

Run in Stdio Mode (for Claude Desktop)

./libreoffice-mcp-server

Run in HTTP Mode

./libreoffice-mcp-server -transport http -port 8080

Configuration

Configure via environment variables:

Worker Pool Settings

• MAX_WORKERS - Max concurrent LibreOffice operations (default: 5)
• QUEUE_SIZE - Max pending requests in queue (default: 10)
• ACQUIRE_TIMEOUT - Time to wait for an available worker (default: 30s)

Execution Settings

• EXECUTION_TIMEOUT - Max operation execution time (default: 60s)
• MAX_CONCURRENT_OPS - Max concurrent operations (default: 5)

LibreOffice Settings

• LIBREOFFICE_PATH - Path to soffice/libreoffice binary (auto-detected if not set)
• TEMP_DIR - Temp directory for operations (default: system temp)
• OUTPUT_DIR - Output directory for generated docs (default: system temp)
• OUTPUT_TTL - TTL for output cleanup (default: 24h)

Server Settings

• TRANSPORT - Transport type: stdio or http (default: stdio)
• HTTP_PORT - Port for HTTP transport (default: 8080)

Storage Settings (HTTP mode)

• STORAGE_DIR - Directory for uploaded files (default: ~/.cache/libre-mcp/uploads)
• UPLOAD_TTL - Auto-delete uploaded files after this duration (default: 1h)
• MAX_UPLOAD_SIZE - Maximum upload file size in bytes (default: 100MB)

Malware Scanning Settings

• SCAN_UPLOADS - Enable ClamAV malware scanning (default: true)
• SCAN_ON_FAIL - Behavior when scanner unavailable: reject or allow (default: reject)

Example Configuration

export MAX_WORKERS=10
export EXECUTION_TIMEOUT=120s
export OUTPUT_TTL=48h
export TRANSPORT=http
export HTTP_PORT=8080
export SCAN_UPLOADS=true
export SCAN

... [View full README on GitHub](https://github.com/sagacient/libreoffice-mcp-server#readme)