Dolibarr

Provides a Dolibarr MCP server with CRUD operations and server-side search to manage Dolibarr ERP/CRM data.

python

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "marioser-dolibarr-mcp": {
      "command": "python",
      "args": [
        "-m",
        "dolibarr_mcp.dolibarr_mcp_server"
      ],
      "env": {
        "LOG_LEVEL": "INFO",
        "DOLIBARR_URL": "https://your-dolibarr.example.com/api/index.php",
        "DOLIBARR_API_KEY": "YOUR_API_KEY",
        "DOLIBARR_SHOP_URL": "https://your-dolibarr.example.com"
      }
    }
  }
}

Dolibarr MCP Server enables you to interact with a Dolibarr ERP/CRM instance through a Model Context Protocol interface. It provides server-side tools for managing customers, products, invoices, orders, and more, with efficient search capabilities to minimize token usage and costs when connected to MCP-aware clients.

How to use

You connect MCP-aware clients to the Dolibarr MCP Server to perform CRUD operations and perform server-side searches against your Dolibarr instance. The server runs locally via Python in a virtual environment and communicates over STDIO by default, or can be exposed over HTTP if you enable the HTTP transport.

How to install

Follow these concrete steps to set up the Dolibarr MCP Server from scratch.

# Linux / macOS
git clone https://github.com/latinogino/dolibarr-mcp.git
cd dolibarr-mcp
python3 -m venv venv_dolibarr
source venv_dolibarr/bin/activate
pip install -e .
# Optional development extras
pip install -e '.[dev]'

# Windows PowerShell
git clone https://github.com/latinogino/dolibarr-mcp.git
Set-Location dolibarr-mcp
py -3 -m venv venv_dolibarr
./venv_dolibarr/Scripts/Activate.ps1
pip install -e .
# Optional development extras (escape brackets in PowerShell)
pip install -e .`[dev`]

# Docker (optional)
docker compose up -d
# or
docker build -t dolibarr-mcp .
docker run -d \
  -e DOLIBARR_URL=https://your-dolibarr.example.com/api/index.php \
  -e DOLIBARR_API_KEY=YOUR_API_KEY \
  dolibarr-mcp

]} ,{

## Configuration and startup notes

Configure environment variables to point the server at your Dolibarr instance and control logging. The server reads from an environment file or environment variables. The following variables are used by the server and should be provided in your environment or a .env file.

DOLIBARR_URL=https://your-dolibarr.example.com/api/index.php DOLIBARR_API_KEY=YOUR_API_KEY DOLIBARR_SHOP_URL=https://your-dolibarr.example.com LOG_LEVEL=INFO

Tools and capabilities

The server exposes a set of specialized tools designed for efficient server-side filtering and common ERP operations. You can perform CRUD actions for users, customers, products, invoices, orders, contacts, and projects, as well as use advanced search helpers to minimize data transfer.

Available tools

CRUD users

Create, read, update, and delete user accounts within Dolibarr via MCP tools.

CRUD customers

Manage customer records with server-side operations and filtering.

CRUD products

Handle product data with CRUD endpoints and server-side search helpers.

CRUD invoices

Create and manage invoices through dedicated MCP endpoints.

CRUD orders

Process orders and related data with server-side access.

CRUD contacts

Manage contact records associated with customers or projects.

CRUD projects

Handle project data through MCP endpoints.

search_products_by_ref

Server-side search to locate products by reference with filtering.

resolve_product_ref

Resolve a product reference to its internal Dolibarr record.

raw_api_access

Direct access to raw Dolibarr API endpoints for advanced usage.

Built by

VeilStrat

AI signals for GTM teams