What you can do with Dolibarr

Built for

Finance Teams, Operations Managers, ERP Administrators, Small Business Owners

Example workflows

Browse product catalog

Grounds inventory questions in live catalog rows instead of guesses.

Try this

List the first 10 products in Dolibarr with ref, label, and price. Flag any with zero stock or missing descriptions.

Review open invoices

Turns billing status into a scannable receivables brief.

Try this

List recent customer invoices in Dolibarr — id, ref, third party name, total, and payment status.

Inspect invoice lines

Shows how to drill from headers into line-level detail.

Try this

Fetch Dolibarr invoice id 42 with line items and summarize products, quantities, and line totals.

List suppliers

Connects procurement workflows to live vendor records.

Try this

List Dolibarr third parties in supplier mode — name, id, and email when present.

Context to know first

What can AI agents do with Dolibarr on MCPBundles?

Agents can list or fetch products, orders, proposals, customer and supplier invoices, third parties, contacts, users, categories, stock movements, projects, warehouses, bank accounts, and shipments. They can also create or update records when the connected API user has write permissions.

How does Dolibarr authentication work on MCPBundles?

Connect your Dolibarr REST API URL (ending in /api/index.php) and a user API key from your instance. MCPBundles stores the connection securely after setup.

Do I need my own Dolibarr server?

Yes. Dolibarr is self-hosted ERP software — MCPBundles connects to an instance you already run or have access to, not a hosted trial from us.

AI Skill
SKILL.md

Domain knowledge for Dolibarr — workflow patterns, data models, and gotchas for your AI agent.

Dolibarr

Self-hosted ERP/CRM: products, orders, proposals, customer and supplier invoices, third parties, contacts, users, categories, stock movements, projects, warehouses, bank accounts, and shipments.

Multicompany (multi-society)

One Dolibarr URL can host multiple legal entities. Dolibarr routes API calls by the DOLAPIENTITY header — not a query parameter.

  1. Discover first when the user mentions multiple societies or entity-specific data — run entity discovery (read-only probe of numeric ids). Results cache on the connection.
  2. Per call — pass entity (numeric id) on reads and writes.
  3. Default — set default_entity on the connection to avoid repeating the id.
  4. When exactly one entity is accessible, discovery auto-selects it. When several are accessible, pass entity or set default_entity.

Operational order

  1. Entities (multicompany only) — discover accessible societies when scope is unclear.
  2. Products / categories — catalog shape and category_id for filtered product lists.
  3. Third parties and contacts — customers (third-party mode=1), suppliers (mode=4), then contacts filtered by socid.
  4. Commercial documents — proposals and orders (headers, then lines via include=lines on reads or line upserts on writes).
  5. Invoices — list headers first; line and payment detail via include on reads.
  6. Stock — warehouses, stock movements, shipments when inventory questions arise.
  7. Company setup — admin-only on many instances.

Writes

  • Upsert pattern: omit id to create draft rows; pass id to update headers.
  • Document lines are separate upserts on the parent document id.
  • Validate actions on orders, proposals, and invoices post workflow/accounting impact — only when the user explicitly asks.
  • Deletes are irreversible on most instances; confirm destructive intent first.

Gotchas

  • REST entry point is /api/index.php on the user's host (not index.html, not bare /api).
  • Without entity, Dolibarr uses its default context — not necessarily the society the user means.
  • Some multicompany installs return HTTP 500 with a valid JSON body; reads still return data.
  • Company setup often requires an admin API key.
  • Category lists require type (e.g. product).
  • Third-party list mode: 1=customers, 4=suppliers.
  • Invoice, order, and proposal detail: use include=lines (and include=payments on customer invoices) when id is set.
  • Projects, bank accounts, and some stock endpoints require modules or permissions the API user may lack.

Tools in this Server (34)

Dolibarr Delete Contacts

Permanently delete a Dolibarr contact by id.

Dolibarr Delete Invoices

Delete a Dolibarr customer invoice by id. Validated invoices may be blocked upstream.

Dolibarr Delete Orders

Delete a Dolibarr sales order by id. Validated orders may require upstream status checks.

Dolibarr Delete Products

Permanently delete a Dolibarr product by id. Irreversible on most instances — confirm with the user before calling.

Dolibarr Delete Proposals

Delete a Dolibarr proposal by id. Draft proposals delete cleanly on most instances.

Dolibarr Delete Thirdparties

Permanently delete a Dolibarr third party by id. May fail when linked documents exist.

Dolibarr Get Bankaccounts

List or fetch Dolibarr bank account records. Omit id to list; pass id for one account. Finance permissions may be required on the API user.

Dolibarr Get Categories

List Dolibarr categories. Requires type on list — use 'product' for product categories, 'customer' for customer categories, 'supplier' for supplier ca...

Dolibarr Get Company

Read Dolibarr company / legal-entity setup (name, address, identifiers). Requires a Dolibarr admin API key or a user allowed by API_LOGINS_ALLOWED_FOR...

Dolibarr Get Contacts

List or fetch Dolibarr contacts (people linked to third parties). Omit id to list; pass id for one contact. Optional socid filters contacts for one th...

Dolibarr Get Invoices

List or fetch Dolibarr customer invoices. Omit id to list; pass id to fetch one invoice. When id is set, optional include selects a sub-resource: 'lin...

Dolibarr Get Orders

List or fetch Dolibarr customer sales orders. Omit id to list; pass id for one order. When id is set, optional include selects 'lines' for order line ...

Dolibarr Get Products

List or fetch Dolibarr products (SKU catalog). Omit id to list with pagination; pass id for one product. Optional category_id lists products linked to...

Dolibarr Get Projects

List or fetch Dolibarr projects. Omit id to list with pagination; pass id for one project. Requires the Projects module on the Dolibarr instance.

Dolibarr Get Proposals

List or fetch Dolibarr commercial proposals (quotes). Omit id to list; pass id for one proposal. When id is set, optional include selects 'lines' for ...

Dolibarr Get Shipments

List or fetch Dolibarr shipment records (outbound deliveries). Omit id to list; pass id for one shipment.

Dolibarr Get Stockmovements

List or fetch Dolibarr warehouse stock movements. Omit id to list with pagination; pass id for one movement record.

Dolibarr Get Supplier Invoices

List or fetch Dolibarr supplier (vendor) invoices. Omit id to list; pass id to fetch one invoice. When id is set, optional include selects 'lines' or ...

Dolibarr Get Thirdparties

List or fetch Dolibarr third parties (customers, prospects, suppliers). Omit id to list; pass id for one party. Optional mode filters the list: 1=cust...

Dolibarr Get Users

List or fetch Dolibarr internal users. Omit id to list with pagination; pass id for one user profile.

Dolibarr Get Warehouses

List or fetch Dolibarr warehouse definitions. Omit id to list; pass id for one warehouse. Used for stock and shipment workflows.

Dolibarr List Entities

Discover Dolibarr multicompany legal entities accessible with the connected API key. Probes entity ids with read-only product requests and caches resu...

Dolibarr Upsert Contacts

Create or update a Dolibarr contact person. Omit id to create; pass id to update. Include socid in data to link the contact to a third party.

Dolibarr Upsert Invoice Lines

Add or update a line on a Dolibarr customer invoice. document_id is the invoice id; omit line_id to add, pass line_id to update. Draft invoices only o...

Dolibarr Upsert Invoices

Create or update a Dolibarr customer invoice. Omit id to create a draft invoice; pass id to update header fields. Validating posts accounting impact —...

Dolibarr Upsert Order Lines

Add or update a line on a Dolibarr sales order. document_id is the order id; omit line_id to POST a new line, pass line_id to PUT an update. Typical d...

Dolibarr Upsert Orders

Create or update a Dolibarr customer sales order. Omit id to create a draft order; pass id to update header fields. Add lines with the order-lines ups...

Dolibarr Upsert Products

Create or update a Dolibarr product (SKU). Omit id to POST a new product; pass id to PUT an update. Send fields in data (ref, label, price, status, .....

Dolibarr Upsert Proposal Lines

Add or update a line on a Dolibarr proposal. document_id is the proposal id; omit line_id to add, pass line_id to update.

Dolibarr Upsert Proposals

Create or update a Dolibarr commercial proposal (quote). Omit id to create a draft; pass id to update header fields. Add lines with the proposal-lines...

Dolibarr Upsert Thirdparties

Create or update a Dolibarr third party (customer, prospect, or supplier). Omit id to create; pass id to update. Use data.name and client/fournisseur ...

Dolibarr Validate Invoice

Validate a Dolibarr customer invoice by id. Posts accounting impact — irreversible on most instances. Use only when the user explicitly requests valid...

Dolibarr Validate Order

Validate (confirm) a Dolibarr sales order by id. Moves the order out of draft and may trigger stock or workflow side effects — use only on explicit us...

Dolibarr Validate Proposal

Validate a Dolibarr commercial proposal by id. Locks the quote for customer send workflows on many instances.

Frequently Asked Questions

What can AI agents do with Dolibarr on MCPBundles?

Agents can list or fetch products, orders, proposals, customer and supplier invoices, third parties, contacts, users, categories, stock movements, projects, warehouses, bank accounts, and shipments. They can also create or update records when the connected API user has write permissions.

How does Dolibarr authentication work on MCPBundles?

Connect your Dolibarr REST API URL (ending in /api/index.php) and a user API key from your instance. MCPBundles stores the connection securely after setup.

Do I need my own Dolibarr server?

Yes. Dolibarr is self-hosted ERP software — MCPBundles connects to an instance you already run or have access to, not a hosted trial from us.

Why might company profile fail while other tools work?

Company setup is admin-only on many Dolibarr instances. Products, invoices, and users usually work with a standard user API key.

How do I connect Dolibarr to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/dolibarr. Authentication is handled automatically.

How many tools does Dolibarr provide?

Dolibarr provides 34 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Dolibarr require?

Dolibarr uses API Key. Dolibarr requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Dolibarr to any MCP client in minutes

MCP URL
https://mcp.mcpbundles.com/bundle/dolibarr

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Dolibarr and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Dolibarr will appear under Not connected — select it and click Connect to complete OAuth.
Name: Dolibarr
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/dolibarr
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Ready to use Dolibarr?

Sign in to connect your credentials and start running tools from the chat.

Dolibarr MCP Server & Skill