# Libre Office Mcp

> MCP server from harshithb3304/libre-office-mcp.

- **Type:** MCP server
- **Install:** `agentstack add mcp-harshithb3304-libre-office-mcp`
- **Verified:** Pending review
- **Seller:** [harshithb3304](https://agentstack.voostack.com/s/harshithb3304)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [harshithb3304](https://github.com/harshithb3304)
- **Source:** https://github.com/harshithb3304/libre-office-mcp

## Install

```sh
agentstack add mcp-harshithb3304-libre-office-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# LibreOffice MCP Server

A Model Context Protocol (MCP) server that enables Claude and other AI assistants to interact with LibreOffice documents directly.

## Overview

This MCP server provides a bridge between AI assistants like Claude and LibreOffice, allowing the AI to create, read, edit, and format LibreOffice documents. Built on the [Model Context Protocol](https://modelcontextprotocol.io/), it exposes LibreOffice functionality as tools that can be called by compatible AI applications.

## Features

### LibreOffice Suite Support

- [x] **LibreWriter**
  - **Implemented:**
    - [x] Create new documents
    - [x] Open and read text documents
    - [x] Copy documents
    - [x] List documents in a directory
    - [x] Get document properties and metadata
    - [x] Add text to documents
    - [x] Add headings with different levels
    - [x] Add formatted paragraphs
    - [x] Add tables with data
    - [x] Format tables with borders, colors, and header rows
    - [x] Search and replace text
    - [x] Delete specific text
    - [x] Delete paragraphs
    - [x] Insert page breaks (partial implementation)
    - [x] Insert images
    - [x] Format specific text (bold, italic, color, size)
  
    
- [ ] **LibreCalc**
- [ ] **LibreImpress**

## Installation

### Requirements
- Python 3.10 or higher
- LibreOffice installed
- Claude for Desktop (or another MCP-compatible client)

### Setup Instructions

1. **Clone the repository**
   ```bash
   git clone https://github.com/harshithb3304/libre-office-mcp.git
   cd libre-office-mcp/libre-writer
   ```

2. **Set up Python environment**
   ```bash
   UV Installation 

   #For Windows  
   powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
   #For MacOS/Linux 
   curl -LsSf https://astral.sh/uv/install.sh | sh

   # With uv (recommended)
   uv init
   uv venv
   uv add mcp[cli] httpx
   
   # With pip
   pip install "mcp[cli]" httpx
   ```

3. **Install LibreOffice**
   - Windows: [Download from LibreOffice website](https://www.libreoffice.org/download/download-libreoffice/)
   - macOS: 
     ```bash
     brew install --cask libreoffice
     ```

## Usage with Claude for Desktop

1. **Configure Claude for Desktop**

   Add the following to your Claude for Desktop configuration file:
   - Windows: `%APPDATA%\Claude\claude_desktop_config.json`
   - macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`

   ```json
   {
     "mcpServers": {
       "libreoffice-server": {
         "command": "uv",
         "args": [
           "--directory",
           "C:\\path\\to\\libreoffice-mcp-server",
           "run",
           "main.py"
         ]
       }
     }
   }
   ``` 
   or 
   ```json 
   {
     "mcpServers": {
       "libreoffice-server": {
          "command": "python",
          "args": [
            "C:\\path\\to\\the\\main.py"
          ]
        }
      }
   }
   
   ```

   > ⚠️ **Note**: Replace `C:\\path\\to\\libreoffice-mcp-server` with the actual path to where you cloned the repository.

2. **Restart Claude for Desktop**

3. **Interact with LibreOffice**

   You can now ask Claude to perform actions like:
   - "Create a new document with a title and three paragraphs"
   - "List all the documents in my Documents folder"
   - "Open my report.odt file and add a table with 4 columns and 5 rows"

## How It Works

The server consists of three main components:

1. **LibreOffice Helper (`helper.py`)**: A Python script that communicates directly with LibreOffice using the UNO bridge API.

2. **MCP Server (`libre.py`)**: The main MCP server that exposes LibreOffice functionality as tools for AI assistants.

3. **Launcher (`main.py`)**: A script that launches both the helper and the MCP server.

When a request comes in from Claude:

1. The MCP server receives the request
2. It forwards the command to the LibreOffice helper via a socket connection
3. The helper executes the command using LibreOffice's UNO API
4. The result is sent back to the MCP server and then to Claude

## Configuration Options

The server will use your Documents folder as the default location for creating new documents if no path is specified. You can change this by modifying the `get_default_document_path` function in `libre.py`.

## Troubleshooting

### Common Issues

- **"LibreOffice helper is not running"**  
  Make sure LibreOffice is installed and the path to the LibreOffice Python executable is correct in `main.py`.

- **"Connection refused"**  
  The helper script may not have started correctly. Check if port 8765 is already in use.

- **"Failed to connect to LibreOffice desktop"**  
  LibreOffice may not be running in headless mode. Check if port 2002 is available.

## Contributing

Contributions are welcome! Here are some areas that need improvement:

- Fixing image insertion functionality
- Implementing robust text formatting
- Supporting additional LibreOffice features
- Improving error handling

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [harshithb3304](https://github.com/harshithb3304)
- **Source:** [harshithb3304/libre-office-mcp](https://github.com/harshithb3304/libre-office-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: flagged — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-harshithb3304-libre-office-mcp
- Seller: https://agentstack.voostack.com/s/harshithb3304
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.