Dolibarr MCP Server

Dolibarr MCP delivers a Model Context Protocol (MCP) interface for the Dolibarr ERP/CRM. The project mirrors the layout of prestashop-mcp: an async API client, a production-ready STDIO server, and focused documentation. Claude Desktop and other MCP-aware tools can use the server to manage customers, products, invoices, orders, and contacts in a Dolibarr instance.

Consult the bundled documentation index for deep dives into configuration, API coverage, and contributor workflows.

✨ Features

• Full ERP coverage – CRUD tools for users, customers, products, invoices, orders, contacts, and raw API access.
• Async/await HTTP client – Efficient Dolibarr API wrapper with structured error handling.
• Ready for MCP hosts – STDIO transport compatible with Claude Desktop out of the box.
• Shared workflow with prestashop-mcp – Identical developer ergonomics and documentation structure across both repositories.

✅ Prerequisites

• Python 3.8 or newer.
• Access to a Dolibarr installation with the REST API enabled and a personal API token.

📦 Installation

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]'

While the virtual environment is active record the Python executable path with which python. Claude Desktop must launch the MCP server using this interpreter.

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`]

Run Get-Command python (or Get-Command python.exe) while the environment is activated and note the absolute path. Claude Desktop should use this interpreter inside the virtual environment, for example C:\\path\\to\\dolibarr-mcp\\venv_dolibarr\\Scripts\\python.exe.

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

Environment variables

The server reads configuration from the environment or a .env file. Both DOLIBARR_URL and DOLIBARR_SHOP_URL are accepted for the base API address.

Variable	Description
DOLIBARR_URL / DOLIBARR_SHOP_URL	Base Dolibarr API endpoint, e.g. https://example.com/api/index.php. Trailing slashes are handled automatically.
DOLIBARR_API_KEY	Personal Dolibarr API token.
LOG_LEVEL	Optional logging verbosity (INFO, DEBUG, WARNING, …).

Example .env:

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

Claude Desktop configuration

Add the following block to claude_desktop_config.json, replacing the paths and credentials with your own values:

{
  "mcpServers": {
    "dolibarr": {
      "command": "C:\\path\\to\\dolibarr-mcp\\venv_dolibarr\\Scripts\\python.exe",
      "args": ["-m", "dolibarr_mcp.dolibarr_mcp_server"],
      "cwd": "C:\\path\\to\\dolibarr-mcp",
      "env": {
        "DOLIBARR_SHOP_URL": "https://your-dolibarr.example.com",
        "DOLIBARR_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Restart Claude Desktop after saving the configuration. The MCP server reads the same environment variables when launched from Linux or macOS hosts.

▶️ Usage

Start the MCP server

The server communicates over STDIO, so run it in the foreground from the virtual environment:

python -m dolibarr_mcp.dolibarr_mcp_server

Logs are written to stderr to avoid interfering with the MCP protocol. Keep the process running while Claude Desktop is active.

Test the Dolibarr credentials

Use the standalone connectivity check before wiring the server into an MCP host:

python -m dolibarr_mcp.test_connection --url https://your-dolibarr.example.com/api/index.php --api-key YOUR_API_KEY

When the environment variables are already set, omit the overrides and run python -m dolibarr_mcp.test_connection.

🧪 Development

• Run the test-suite with pytest (see docs/development.md for coverage options and Docker helpers).
• Editable installs rely on the src/ layout and expose the dolibarr-mcp console entry point for backwards compatibility.
• The repository structure, tooling, and docs intentionally mirror prestashop-mcp to keep the companion projects aligned.

📄 License

Released under the MIT License.