Skip to main content
Glama
deenesjakoruzh
passerbyflutter

LibreOffice MCP Tools

by passerbyflutter
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

Herramientas MCP para LibreOffice

npm version

[!WARNING] Este proyecto fue escrito por GitHub Copilot y no ha sido revisado completamente por un humano. El código puede contener errores, problemas de seguridad o comportamientos inesperados. Úselo bajo su propia responsabilidad. No lo utilice en producción sin una revisión exhaustiva.

Un servidor del Protocolo de Contexto de Modelo (MCP) que brinda a los agentes de IA (Claude, Copilot, Gemini, Cursor, etc.) la capacidad de leer, escribir y editar documentos de Office a través de LibreOffice, con un diseño eficiente en el uso de tokens que minimiza el consumo de contexto del LLM.

Inspirado en la arquitectura de chrome-devtools-mcp.

✨ Características

  • 22 herramientas MCP que cubren lectura, escritura, hojas de cálculo y presentaciones

  • Diseño eficiente en tokens: navegación basada en esquemas, acceso basado en rangos, paginación

  • Amplia compatibilidad de formatos: DOCX, DOC, XLSX, XLS, PPTX, PPT, ODT, ODS, ODP, RTF, CSV, TXT, PDF

  • Puente para formatos heredados: conversión automática de .doc, .xls, .ppt mediante LibreOffice antes del análisis

  • No se requiere LibreOffice para lecturas básicas: los analizadores nativos manejan DOCX, XLSX, PPTX directamente

  • LibreOffice requerido para: formatos heredados, exportación a PDF, conversión de formatos

Related MCP server: Spire.Doc MCP Server

📋 Formatos admitidos

Formato

Extensiones

Leer

Escribir

Método

Word 2007+

.docx, .dotx

✅

✅

Nativo (lectura con mammoth / escritura OOXML con JSZip)

Word 97-2003

.doc, .dot

✅

✅

Puente de LibreOffice

Excel 2007+

.xlsx, .xlsm

✅

✅

Nativo (ExcelJS)

Excel 97-2003

.xls

✅

✅

Puente de LibreOffice

PowerPoint 2007+

.pptx

✅

✅

Nativo (OOXML con JSZip)

PowerPoint 97-2003

.ppt

✅

✅

Puente de LibreOffice

OpenDocument Text

.odt

✅

✅

Puente de LibreOffice

OpenDocument Spreadsheet

.ods

✅

✅

Puente de LibreOffice

OpenDocument Presentation

.odp

✅

✅

Puente de LibreOffice

Rich Text Format

.rtf

✅

✅

Puente de LibreOffice

CSV

.csv

✅

✅

Nativo

PDF

.pdf

✅ (texto)

❌

CLI de LibreOffice

Texto plano

.txt

✅

✅

Nativo

🚀 Inicio rápido

Requisitos previos

  • Node.js 20+

  • LibreOffice (opcional para lecturas básicas de DOCX/XLSX/PPTX; requerido para .doc/.xls/.ppt y conversión de formatos)

    • Windows: Descargar LibreOffice

    • macOS: brew install --cask libreoffice

    • Linux: sudo apt install libreoffice o sudo dnf install libreoffice

Instalación

Usando npx (recomendado — no requiere instalación):

{
  "mcpServers": {
    "libreoffice": {
      "command": "npx",
      "args": ["-y", "@passerbyflutter/libreoffice-mcp-tools"]
    }
  }
}

Instalación global:

npm install -g @passerbyflutter/libreoffice-mcp-tools

Desde el código fuente:

git clone https://github.com/passerbyflutter/libreoffice-mcp-tools
cd libreoffice-mcp-tools
npm install
npm run build

Configure su cliente MCP

Añada a la configuración de su cliente MCP (por ejemplo, claude_desktop_config.json de Claude Desktop):

{
  "mcpServers": {
    "libreoffice": {
      "command": "npx",
      "args": ["-y", "@passerbyflutter/libreoffice-mcp-tools"],
      "env": {
        "SOFFICE_PATH": "/path/to/soffice"
      }
    }
  }
}

O utilice .mcp.json en la raíz de su proyecto:

{
  "mcpServers": {
    "libreoffice": {
      "command": "npx",
      "args": ["-y", "@passerbyflutter/libreoffice-mcp-tools"]
    }
  }
}

Opciones de CLI

node build/bin/libreoffice-mcp.js [options]

  --libreoffice-path <path>   Path to soffice executable
                              (default: auto-detected or SOFFICE_PATH env)

🛠 Referencia de herramientas

Gestión de documentos

Herramienta

Descripción

document_open

Abre un archivo → devuelve un identificador docId. Realiza el puente automático de formatos heredados.

document_close

Libera el identificador del documento y los archivos temporales

document_list

Lista todos los documentos abiertos

document_create

Crea un nuevo documento vacío (writer/calc/impress)

document_save

Guarda en la ruta actual o en una nueva

document_export

Exporta a través de LibreOffice (PDF, HTML, CSV, etc.)

document_convert

Convierte el formato de archivo (DOC→DOCX, XLSX→CSV, etc.)

Lectura (eficiente en tokens)

Herramienta

Descripción

document_get_metadata

Título, autor, recuento de palabras/páginas, fechas

document_get_outline

Encabezados (Writer) / nombres de hojas (Calc) / títulos de diapositivas (Impress)

document_read_text

Texto del documento paginado como Markdown

document_read_range

Rango específico de párrafos o diapositivas

document_search

Encuentra texto con contexto circundante

Escritura (Writer)

Herramienta

Descripción

document_insert_text

Inserta al principio/final/después de un encabezado

document_replace_text

Buscar y reemplazar (primera o todas las apariciones)

document_insert_paragraph

Inserta un párrafo en un índice específico

document_apply_style

Aplica un estilo de encabezado/párrafo

Hoja de cálculo (Calc)

Herramienta

Descripción

spreadsheet_list_sheets

Nombres de hojas con recuento de filas/columnas

spreadsheet_get_range

Rango de celdas como JSON + tabla markdown

spreadsheet_set_cell

Establece el valor o la fórmula de una celda

spreadsheet_set_range

Establece un rango 2D de valores

spreadsheet_add_sheet

Añade una nueva hoja

spreadsheet_get_formulas

Obtiene expresiones de fórmulas en un rango

Presentación (Impress)

Herramienta

Descripción

presentation_list_slides

Títulos de diapositivas con índice

presentation_get_slide

Contenido completo de la diapositiva (título, cuerpo, notas)

presentation_get_notes

Notas del orador

presentation_add_slide

Añade una nueva diapositiva (requiere LibreOffice)

presentation_update_slide

Actualiza el contenido de la diapositiva

💡 Flujo de trabajo para ahorrar tokens

Para una máxima eficiencia en el uso de tokens, siga este patrón:

1. document_open(filePath) → get docId
2. document_get_metadata(docId) → understand size/type
3. document_get_outline(docId) → see structure
4. document_read_range(docId, startIndex=N, endIndex=M) → read specific section

En lugar de volcar todo el documento, navegue exactamente a lo que necesita.

Flujo de trabajo de hojas de cálculo:

1. document_open(path) → docId
2. spreadsheet_list_sheets(docId) → see all sheets
3. spreadsheet_get_range(docId, sheetName="Sales", range="A1:D20") → targeted data

🏗 Arquitectura

src/
├── index.ts                # createMcpServer() — MCP server factory
├── LibreOfficeAdapter.ts   # soffice subprocess manager
├── DocumentContext.ts      # Open document registry
├── DocumentSession.ts      # Per-document state + format bridge
├── McpResponse.ts          # Response builder (text/JSON/markdown)
├── Mutex.ts                # Serializes LibreOffice subprocess calls
├── parsers/
│   ├── DocxParser.ts           # DOCX read → {paragraphs, outline, metadata} (mammoth)
│   ├── DocxOoxmlEditor.ts      # DOCX write → direct JSZip OOXML manipulation (format-preserving)
│   ├── XlsxParser.ts           # XLSX read/write via ExcelJS
│   ├── PptxParser.ts           # PPTX read → {slides[]} (JSZip XML)
│   └── PptxOoxmlEditor.ts      # PPTX write → add/update slides, create PPTX (JSZip OOXML)
├── formatters/
│   ├── MarkdownFormatter.ts
│   ├── JsonFormatter.ts
│   └── TableFormatter.ts   # Spreadsheet → Markdown table
└── tools/
    ├── documents.ts         # open/close/list/create
    ├── reader.ts            # metadata/outline/read/search
    ├── writer.ts            # insert/replace/style
    ├── spreadsheet.ts       # get/set cells/ranges/sheets
    ├── presentation.ts      # slides/notes
    └── converter.ts         # save/export/convert

🧪 Pruebas

# Create sample fixtures
node tests/create-fixtures.mjs

# Run smoke tests
npm test

📝 Variables de entorno

Variable

Descripción

SOFFICE_PATH

Ruta al ejecutable soffice de LibreOffice

DEBUG

Establecer en lo-mcp:* para un registro detallado

📄 Licencia

MIT

Install Server
A
license - permissive license
A
quality
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • writespace-mcp

    Persistent docs and memory for AI agents — read, write, organize & search a shared workspace.

  • superdocs

    AI document editing for agents: draft, edit, export .docx/PDF. 37 MCP tools; agent self-signup.

  • agentbay-mcp

    Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.

View all MCP Connectors

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/passerbyflutter/libreoffice-mcp-tools'

If you have feedback or need assistance with the MCP directory API, please join our Discord server