Skip to main content
Glama
mcp-dolibarr

mcp-dolibarr

mcp-dolibarr

An MCP server for the Dolibarr ERP/CRM REST API.

  • Read-only by default. Write tools only exist when DOLIBARR_ALLOW_WRITE=true, and carry MCP annotations so the client asks before running them.

  • Compact answers. Empty values are dropped from every answer, to save the model's context. The tools are listed in docs/tools.md.

Dolibarr setup

Dolibarr 24 or later.

  1. Enable the API REST module (Home → Setup → Modules).

  2. Create a dedicated user, give it only the permissions the agent needs (read-only rights for a read-only server), and generate its API key on its user card.

The API key carries that user's permissions: Dolibarr enforces them whatever this server allows.

Related MCP server: EspoCRM Assistant

Configuration

Each setting is an environment variable and, except the API key, a command-line option (--url, --port... see mcp-dolibarr --help). The option wins over the variable, which wins over the .env file of the working directory (copy .env.example), which wins over the default. Keep the API key in the environment or in .env: an option would show in ps and in the shell history.

Variable

Default

Meaning

DOLIBARR_URL

required

API root, ending with /api/index.php

DOLIBARR_API_KEY

required

API key of the Dolibarr user

DOLIBARR_ALLOW_WRITE

false

Register the tools that write to Dolibarr

MCP_TRANSPORT

stdio

stdio, or http (streamable HTTP, served at /mcp)

MCP_HOST

127.0.0.1

HTTP bind address

MCP_PORT

8000

HTTP port

Run

Requires uv.

uv run mcp-dolibarr

Claude Code, over stdio:

claude mcp add dolibarr -- uv run --directory /path/to/mcp-dolibarr mcp-dolibarr

The HTTP transport has no authentication: keep it on localhost, or behind a reverse proxy that authenticates.

Contributing

Issues and pull requests are welcome.

  • One issue per change. Branch from dev, named <type>/<short-description> (feat/, fix/, docs/…).

  • Commits and pull request titles follow Conventional Commits.

  • Pull requests target dev and are squash-merged; dev goes to main at each release.

AI coding agents follow AGENTS.md.

Development

With uv:

uv sync --extra dev
uv run ruff format && uv run ruff check && uv run pytest -q

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables read-only access to FileMaker databases through the Data API, allowing users to retrieve records, analyze metadata, search across layouts, and infer relationships while maintaining data security.
      16
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      Provides read-only EspoCRM access for AI assistants, enabling record retrieval and preparation of signed change sets without direct modification or deletion.
      7
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to natively interact with Dolibarr ERP/CRM through its REST API, providing over 30 tools for managing customers, contacts, products, quotes, orders, invoices, stock, projects, contracts, interventions, and PDF generation, while supporting complex workflow orchestration and read-only security modes.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables per-user Dolibarr API access with allowlisted tools for identity, time reporting, sales records, and leave requests, preserving Dolibarr's per-user permissions.
      MIT