odoo_searchLABSCO SUMMARY
The whole Odoo model layer, one connection wide.
Because the tools take a model name rather than wrapping specific business objects, anything in the instance is reachable — partners, invoices, stock, custom models alike. That generality cuts both ways: delete is in the set, and the Odoo account's permissions are the only boundary.
What it is
A TypeScript MCP server that connects to any Odoo instance over XML-RPC and exposes the standard Odoo record operations.
What you get
- Record search against any Odoo model with a domain filter and a limit
- Records read by ID with a chosen field list, and search combined with read in one call
- A count of matching records for when you want the number, not the rows
- Field definitions for a model, which is what makes querying an unfamiliar model possible
- Records created, written to, and deleted
- Per-project and per-environment configuration, chosen with
--projectand--environmenton the launch command
Requirements
Odoo credentials: ODOO_URL, ODOO_DATABASE, ODOO_USERNAME and ODOO_PASSWORD, which take priority over the config file at ~/.odoo_config/. Node with npm for the install. The account's own Odoo permissions decide what the tools can reach.
Setup effort
Build from source — git clone https://github.com/odoo-dgoo2308/xml-rpc-odoo-mcp.git
USE CASES
01
Answering a question about your Odoo data
Search a model with a domain filter and read back only the fields you need, in one call.
02
Working with a model you have never queried
Read the field definitions first, so the domain and field list are built from real names.
03
Getting a count without pulling the rows
Ask how many records match the domain when the number is the answer.
04
Creating records from a conversation
Create the record in the right model directly, rather than clicking through the Odoo form.
05
Fixing a field across several records
Find the records that need the change, then write the new value to them.
06
Cleaning up test data
Read the records back to confirm what you have, then delete them.
8 tools
Listed in project docs. Your client may show a different list.
odoo_readodoo_createodoo_writeodoo_unlinkodoo_search_countodoo_fields_getodoo_search_readBEFORE YOU INSTALL
What to know first
Tools you get
8 tools named in the project's documentation.
Requires
- odoo-xmlrpc-mcp-server on PATH
- Node.js 18+
- ODOO_PASSWORD in your environment
- ODOO_URL in your environment
- ODOO_DATABASE in your environment
- ODOO_USERNAME in your environment
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/odoo-dgoo2308/xml-rpc-odoo-mcp.git
cd xml-rpc-odoo-mcp
npm install
npm run build
npm install -g .MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"odoo-xmlrpc": {
"command": "odoo-xmlrpc-mcp-server",
"args": [
"--project",
"<YOUR_PROJECT>",
"--environment",
"<YOUR_ENV>"
],
"env": {
"ODOO_URL": "https://<YOUR_ODOO>.domain.com",
"ODOO_DATABASE": "<YOUR_ODOO_DATABASE>",
"ODOO_USERNAME": "<YOUR_ODOO_USERNAME>",
"ODOO_PASSWORD": "<YOUR_ODOO_PASSWORD>"
}
}
}
}
