dolibarr-api-mcp

MCP server for Dolibarr ERP/CRM REST API operations

| Field | Value | |---|---| | Language | TypeScript | | License | GPL-3.0-or-later | | Platform | Gitea | | Node.js | >= 20.0.0 | | MCP SDK | @modelcontextprotocol/sdk ^1.12.1 |

A Model Context Protocol (MCP) server that bridges AI assistants (Claude Code, Cursor, etc.) with Dolibarr's built-in REST API. Manage invoices, proposals, orders, products, third parties, projects, and more -- directly from your AI assistant.

Quick Start

git clone https://git.mokoconsulting.tech/MokoConsulting/dolibarr-api-mcp.git
cd dolibarr-api-mcp
npm install
npm run build
npm run setup

The interactive setup wizard will prompt for your Dolibarr instance URL, API key, and TLS settings.

Register with Claude Code (~/.claude.json):

{
  "mcpServers": {
    "dolibarr-api": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/dolibarr-api-mcp/dist/index.js"]
    }
  }
}

Verify with: dolibarr_status -- returns the Dolibarr version and server info.

Tools (85)

Every tool accepts an optional connection parameter to target a specific named Dolibarr instance (defaults to the configured default).

Third Parties (5)

| Tool | Description | |---|---| | dolibarr_thirdparties_list | List/search third parties with pagination and SQL filters | | dolibarr_thirdparty_get | Get a third party by ID | | dolibarr_thirdparty_create | Create a new third party (customer, supplier, or prospect) | | dolibarr_thirdparty_update | Update an existing third party | | dolibarr_thirdparty_delete | Delete a third party |

Contacts (5)

| Tool | Description | |---|---| | dolibarr_contacts_list | List/search contacts with pagination | | dolibarr_contact_get | Get a contact by ID | | dolibarr_contact_create | Create a new contact linked to a third party | | dolibarr_contact_update | Update an existing contact | | dolibarr_contact_delete | Delete a contact |

Invoices (7)

| Tool | Description | |---|---| | dolibarr_invoices_list | List/search invoices with status and date filters | | dolibarr_invoice_get | Get an invoice by ID | | dolibarr_invoice_create | Create a new invoice for a third party | | dolibarr_invoice_add_line | Add a line item to an invoice | | dolibarr_invoice_validate | Validate a draft invoice | | dolibarr_invoice_set_paid | Mark an invoice as paid | | dolibarr_invoice_add_payment | Record a payment against an invoice | | dolibarr_invoice_payments | List payments for an invoice |

Proposals / Quotes (7)

| Tool | Description | |---|---| | dolibarr_proposals_list | List/search proposals with pagination | | dolibarr_proposal_get | Get a proposal by ID | | dolibarr_proposal_create | Create a new proposal for a third party | | dolibarr_proposal_add_line | Add a line item to a proposal | | dolibarr_proposal_validate | Validate a draft proposal | | dolibarr_proposal_close | Close a proposal (signed or refused) |

Orders (5)

| Tool | Description | |---|---| | dolibarr_orders_list | List/search orders with pagination | | dolibarr_order_get | Get an order by ID | | dolibarr_order_create | Create a new order for a third party | | dolibarr_order_add_line | Add a line item to an order | | dolibarr_order_validate | Validate a draft order |

Products & Services (5)

| Tool | Description | |---|---| | dolibarr_products_list | List/search products and services | | dolibarr_product_get | Get a product by ID | | dolibarr_product_create | Create a new product or service | | dolibarr_product_update | Update an existing product | | dolibarr_product_stock | Get stock levels for a product |

Projects (4)

| Tool | Description | |---|---| | dolibarr_projects_list | List/search projects | | dolibarr_project_get | Get a project by ID | | dolibarr_project_create | Create a new project | | dolibarr_project_update | Update an existing project |

Tasks (6)

| Tool | Description | |---|---| | dolibarr_tasks_list | List tasks (optionally filtered by project) | | dolibarr_task_get | Get a task by ID | | dolibarr_task_create | Create a new task within a project | | dolibarr_task_update | Update an existing task | | dolibarr_task_timespent_list | List time entries for a task | | dolibarr_task_timespent_add | Add a time entry to a task |

Contracts (4)

| Tool | Description | |---|---| | dolibarr_contracts_list | List/search contracts | | dolibarr_contract_get | Get a contract by ID | | dolibarr_contract_create | Create a new contract | | dolibarr_contract_validate | Validate a draft contract |

Shipments (5)

| Tool | Description | |---|---| | dolibarr_shipments_list | List/search shipments | | dolibarr_shipment_get | Get a shipment by ID | | dolibarr_shipment_create | Create a new shipment from an order | | dolibarr_shipment_validate | Validate a draft shipment | | dolibarr_shipment_close | Close a shipment |

Agenda Events (4)

| Tool | Description | |---|---| | dolibarr_agendaevents_list | List/search agenda events | | dolibarr_agendaevent_get | Get an agenda event by ID | | dolibarr_agendaevent_create | Create a new agenda event | | dolibarr_agendaevent_update | Update an existing agenda event |

Tickets (3)

| Tool | Description | |---|---| | dolibarr_tickets_list | List/search tickets | | dolibarr_ticket_get | Get a ticket by ID | | dolibarr_ticket_create | Create a new support ticket |

Members (2)

| Tool | Description | |---|---| | dolibarr_members_list | List/search members (foundation/association module) | | dolibarr_member_get | Get a member by ID |

Users (3)

| Tool | Description | |---|---| | dolibarr_users_list | List Dolibarr users | | dolibarr_user_get | Get a user by ID | | dolibarr_user_create | Create a new Dolibarr user |

Expense Reports (3)

| Tool | Description | |---|---| | dolibarr_expensereports_list | List/search expense reports | | dolibarr_expensereport_get | Get an expense report by ID | | dolibarr_expensereport_create | Create a new expense report |

Interventions (2)

| Tool | Description | |---|---| | dolibarr_interventions_list | List/search interventions | | dolibarr_intervention_get | Get an intervention by ID |

Documents (3)

| Tool | Description | |---|---| | dolibarr_documents_list | List documents attached to a module element | | dolibarr_document_download | Download a document file | | dolibarr_document_builddoc | Generate a PDF document for an element |

Stock & Warehouses (3)

| Tool | Description | |---|---| | dolibarr_warehouses_list | List warehouses | | dolibarr_stockmovements_list | List stock movements | | dolibarr_stockmovement_create | Create a stock movement |

Bank Accounts (2)

| Tool | Description | |---|---| | dolibarr_bankaccounts_list | List bank accounts | | dolibarr_bankaccount_lines | List transaction lines for a bank account |

Categories (3)

| Tool | Description | |---|---| | dolibarr_categories_list | List categories by type | | dolibarr_category_get | Get a category by ID | | dolibarr_category_create | Create a new category |

Supplier Invoices & Orders (2)

| Tool | Description | |---|---| | dolibarr_supplier_invoices_list | List supplier (vendor) invoices | | dolibarr_supplier_orders_list | List supplier (vendor) orders |

Setup & System (5)

| Tool | Description | |---|---| | dolibarr_status | Check Dolibarr instance status and version | | dolibarr_setup_company | Get company/organization setup info | | dolibarr_setup_modules | List enabled Dolibarr modules | | dolibarr_setup_dictionary | Query Dolibarr dictionary tables (countries, currencies, etc.) | | dolibarr_list_connections | List all configured Dolibarr connections |

Generic (1)

| Tool | Description | |---|---| | dolibarr_api_request | Make a raw API request to any Dolibarr endpoint |

Configuration

The config file is stored at ~/.dolibarr-api-mcp.json (or set DOLIBARR_API_MCP_CONFIG for a custom path):

{
  "defaultConnection": "production",
  "connections": {
    "production": {
      "baseUrl": "https://erp.example.com",
      "apiKey": "your-api-key"
    },
    "staging": {
      "baseUrl": "https://erp-staging.example.com",
      "apiKey": "your-staging-key",
      "insecure": true
    }
  }
}

| Field | Required | Description | |---|---|---| | defaultConnection | Yes | Name of the default connection | | connections | Yes | Map of named connections | | baseUrl | Yes | Dolibarr instance URL (no trailing slash) | | apiKey | Yes | Dolibarr API key (DOLAPIKEY header auth) | | insecure | No | Set true to skip TLS verification (self-signed certs) |

Architecture

AI Assistant  <-->  MCP (stdio)  <-->  DolibarrClient  <-->  Dolibarr REST API
                                                              /api/index.php

• Transport: stdio (standard input/output)
• Auth: DOLAPIKEY HTTP header (Dolibarr's native per-user API key)
• HTTP: Uses node:https/node:http (not fetch) for reliable self-signed TLS support on Node.js 24+
• Validation: Zod schemas for all tool inputs
• Filtering: buildSqlFilter() helper for Dolibarr's sqlfilters parameter with injection-safe escaping

Source Layout

| File | Purpose | |---|---| | src/index.ts | Server entry point -- registers all MCP tools with Zod schemas | | src/client.ts | DolibarrClient HTTP class (GET/POST/PUT/DELETE) | | src/config.ts | Configuration loader for multi-instance connections | | src/types.ts | TypeScript interfaces (DolibarrConnection, DolibarrConfig, ApiResponse) | | scripts/setup.mjs | Interactive setup wizard for creating the config file | | config.example.json | Example configuration with multiple connections |

Examples

List all customers:

dolibarr_thirdparties_list with search="acme", limit=10

Create an invoice and add a line:

dolibarr_invoice_create with socid=42
dolibarr_invoice_add_line with id=<invoice_id>, desc="Consulting services", subprice=150.00, qty=8
dolibarr_invoice_validate with id=<invoice_id>

Check a specific Dolibarr instance:

dolibarr_status with connection="staging"

Raw API request for unsupported endpoints:

dolibarr_api_request with method="GET", endpoint="/categories", params={"type": "product"}

Guides

| Page | Description | |---|---| | INSTALLATION | Prerequisites, install steps, Claude Code registration, troubleshooting |

Reference

| Page | Description | |---|---| | ARCHITECTURE | Component overview, design decisions, data flow, API module coverage |

Documentation

Full documentation is available on the Wiki.

Contributing

See CONTRIBUTING.md for development guidelines and contribution instructions.

License

This project is licensed under the GNU General Public License v3.0 or later -- see the LICENSE file.

Moko Consulting -- MokoStandards