search_recordsLABSCO SUMMARY
A second interface to Odoo, not a replacement for the first.
The project is straightforward about the split: complex configuration still belongs in the Odoo UI, while quick lookups, bulk questions and creating records on the fly are faster asked. Because it works against any model, the useful first question is often which fields a model has - that answer is what makes the next request precise.
What it is
A connector to Odoo's external API that works against any model rather than a fixed set - sales, invoices, contacts, inventory, CRM, HR. The AI becomes a second interface beside the Odoo UI, faster for lookups and bulk questions.
What you get
- Search records with domain filters, and read one by ID
- Create a record or several at once, update one or many, and delete singly or in batches
- Call a model method directly, for the operations that are not plain CRUD
- List the available models, so the agent can find the right one before querying it
- Workflow actions such as confirming and posting, which is what turns a draft into a real document
- Bulk import of records, and server information for checking what you are connected to
Requirements
Python 3.10+ and an Odoo instance whose external API you can reach; the project states support for Odoo 14 through 19 and newer. Authentication is OAuth 2.1. A hosted version handles the OAuth and key storage if you would rather not run it. The licence is Elastic 2.0, which is source-available rather than open source.
Setup effort
Follow the published steps — pip install "mcp-server-odoo @ git+https://github.com/pantalytics/odoo-mcp-pro.git"
USE CASES
01
Answering a question the reports do not cover
Search the model with the filter that expresses the question, and read the records that come back.
02
Creating a record without opening a form
State what it is - a lead, a contact, a quotation - and let it write the record with the fields you gave.
03
Fixing a batch of records at once
Find the matching set, then update them in one call instead of editing each in the UI.
04
Finding out what a model can hold
List the models, then read the fields on the one you need before writing anything to it.
05
Moving a document through its workflow
Confirm the order or post the entry through the workflow action, rather than only editing fields.
12 tools
Listed in project docs. Your client may show a different list.
get_recordlist_modelslist_resource_templatescreate_recordcreate_recordsupdate_recordupdate_recordsdelete_recorddelete_recordsimport_recordsserver_infoBEFORE YOU INSTALL
What to know first
Tools you get
12 tools named in the project's documentation.
Requires
ODOO_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install "mcp-server-odoo @ git+https://github.com/pantalytics/odoo-mcp-pro.git"MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"odoo": {
"command": "python",
"args": [
"-m",
"mcp_server_odoo"
],
"env": {
"ODOO_URL": "https://mycompany.odoo.com",
"ODOO_API_KEY": "<YOUR_ODOO_API_KEY>"
}
}
}
}
