Summary
Connects Claude to Odoo 16+ instances through XML-RPC or JSON-2 APIs without requiring any server-side modules or admin setup. Exposes 24 tools for reading records, server-side aggregation, schema inspection, chatter posting, and addon scanning, plus gated write operations that require approval tokens. Includes migration helpers for JSON-2 transition and diagnostic tools for access rules and upgrade risks. Works with existing Odoo credentials and handles both local development and production instances. The safe write workflow and real Odoo smoke testing make this solid for automation workflows where you need reliable ERP integration without direct database access.
Install to Claude Code
verifiedclaude mcp add mcp-odoo --env ODOO_URL=YOUR_ODOO_URL --env ODOO_DB=YOUR_ODOO_DB --env ODOO_USERNAME=YOUR_ODOO_USERNAME --env ODOO_PASSWORD=YOUR_ODOO_PASSWORD -- uvx odoo-mcpRun in your terminal. Replace YOUR_* placeholders with real values; add --scope user to install for every project.
Review the command, arguments, and environment values before installing — MCP servers run with your local permissions.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Tools
Verified live against the running server on Jun 10, 2026.
verified live26 tools
diagnose_odoo_callDiagnose an Odoo model call without executing it10 params
Diagnose an Odoo model call without executing it
Parameters* required
argsvalueinclude_debugbooleandefault: false
kwargsvaluemetadatavaluemethod*stringmodel*stringobserved_errorvaluetarget_versionvaluetransportstringdefault: auto
use_live_metadatabooleandefault: false
generate_json2_payloadBuild a JSON-2 request preview without network access7 params
Build a JSON-2 request preview without network access
Parameters* required
argsvaluebase_urlvaluedatabasevalueinclude_database_headerbooleandefault: true
kwargsvaluemethod*stringmodel*stringinspect_model_relationshipsInspect model relationships and required field metadata6 params
Inspect model relationships and required field metadata
Parameters* required
fields_metadatavalueinclude_computedbooleandefault: true
include_readonlybooleandefault: true
instancevaluemodel*stringuse_live_metadatabooleandefault: true
diagnose_accessDiagnose ACL and record-rule visibility for an Odoo model9 params
Diagnose ACL and record-rule visibility for an Odoo model
Parameters* required
domainvalueexpected_countvalueinclude_rulesbooleandefault: true
instancevaluelimitintegerdefault: 50
model*stringobserved_errorvalueoperationstringdefault: read
record_idsvalueupgrade_risk_reportReport Odoo upgrade and JSON-2 migration risks8 params
Report Odoo upgrade and JSON-2 migration risks
Parameters* required
include_debugbooleandefault: false
methodsvaluemodulesvalueobserved_errorsvaluesource_findingsvaluesource_versionvaluetarget_versionvalueuse_live_metadatabooleandefault: false
lookup_model_historyLook up Odoo model rename/removal history by old or new model name (e.g. account.invoice -> account.move)1 params
Look up Odoo model rename/removal history by old or new model name (e.g. account.invoice -> account.move)
Parameters* required
name*stringfit_gap_reportClassify Odoo requirements into fit/gap implementation buckets6 params
Classify Odoo requirements into fit/gap implementation buckets
Parameters* required
available_fieldsvalueavailable_modelsvaluebusiness_contextvalueinstalled_modulesvaluerequirements*arrayuse_live_metadatabooleandefault: false
get_odoo_profileRead a bounded profile of the connected Odoo environment3 params
Read a bounded profile of the connected Odoo environment
Parameters* required
include_modulesbooleandefault: true
instancevaluemodule_limitintegerdefault: 100
schema_catalogBuild and cache a bounded Odoo model schema catalog6 params
Build and cache a bounded Odoo model schema catalog
Parameters* required
include_fieldsbooleandefault: false
instancevaluelimitintegerdefault: 50
modelsvaluequeryvaluerefreshbooleandefault: false
preview_writePreview create, write, or unlink without executing it6 params
Preview create, write, or unlink without executing it
Parameters* required
contextvalueinstancevaluemodel*stringoperation*stringrecord_idsvaluevaluesvaluevalidate_writeValidate a standard write payload against optional fields_get metadata8 params
Validate a standard write payload against optional fields_get metadata
Parameters* required
contextvaluefields_metadatavalueinstancevaluemodel*stringoperation*stringrecord_idsvalueuse_live_metadatabooleandefault: true
valuesvalueexecute_approved_writeExecute a previously previewed and confirmed standard write2 params
Execute a previously previewed and confirmed standard write
Parameters* required
approval*objectconfirmbooleandefault: false
scan_addons_sourceScan local Odoo addon source without importing addon code3 params
Scan local Odoo addon source without importing addon code
Parameters* required
addons_pathsvaluemax_file_bytesintegerdefault: 300000
max_filesintegerdefault: 200
build_domainBuild a validated Odoo domain from structured conditions3 params
Build a validated Odoo domain from structured conditions
Parameters* required
conditions*arrayfields_metadatavaluelogical_operatorstringdefault: and
business_pack_reportReport expected modules, models, and safe discovery calls for a business pack3 params
Report expected modules, models, and safe discovery calls for a business pack
Parameters* required
instancevaluepack*stringuse_live_metadatabooleandefault: true
health_checkReport this MCP server's non-secret runtime safety posture
Report this MCP server's non-secret runtime safety posture
No parameters — call it with no arguments.
list_instancesList configured Odoo instance names without credentials
List configured Odoo instance names without credentials
No parameters — call it with no arguments.
execute_methodExecute a custom method on an Odoo model5 params
Execute a custom method on an Odoo model
Parameters* required
argsvalueinstancevaluekwargsvaluemethod*stringmodel*stringlist_modelsList Odoo models with optional name filtering3 params
List Odoo models with optional name filtering
Parameters* required
instancevaluelimitintegerdefault: 100
queryvalueget_model_fieldsGet field metadata for a specific Odoo model5 params
Get field metadata for a specific Odoo model
Parameters* required
field_namesvalueinstancevaluemax_fieldsintegerdefault: 30
model*stringrelevancevaluesearch_recordsSearch Odoo records with read-only search_read7 params
Search Odoo records with read-only search_read
Parameters* required
domainvaluefieldsvalueinstancevaluelimitintegerdefault: 10
model*stringoffsetintegerdefault: 0
ordervalueread_recordRead a single Odoo record by model and ID4 params
Read a single Odoo record by model and ID
Parameters* required
fieldsvalueinstancevaluemodel*stringrecord_id*integeraggregate_recordsAggregate Odoo records server-side using Postgres groupby/sum/count. Uses formatted_read_group on Odoo 19+ and read_group on earlier versions.9 params
Aggregate Odoo records server-side using Postgres groupby/sum/count. Uses formatted_read_group on Odoo 19+ and read_group on earlier versions.
Parameters* required
domainvaluegroup_by*arrayinstancevaluelazybooleandefault: false
limitvaluemeasuresvaluemodel*stringoffsetintegerdefault: 0
ordervaluechatter_postPost a chatter message on a mail.thread record. Default mode requires an approval token returned from a preview call; set MCP_CHATTER_DIRECT=1 to bypass and post immediately.10 params
Post a chatter message on a mail.thread record. Default mode requires an approval token returned from a preview call; set MCP_CHATTER_DIRECT=1 to bypass and post immediately.
Parameters* required
approvalvalueattachment_idsvaluebody*stringconfirmbooleandefault: false
instancevaluemessage_typestringdefault: comment
model*stringpartner_idsvaluerecord_id*integersubtype_xmlidvaluesearch_employeeSearch for employees by name3 params
Search for employees by name
Parameters* required
instancevaluelimitintegerdefault: 20
name*stringsearch_holidaysSearch for holidays within a date range4 params
Search for holidays within a date range
Parameters* required
employee_idvalueend_date*stringinstancevaluestart_date*stringFeatured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Configuration
ODOO_URL*Odoo server URL, e.g. https://mycompany.odoo.com
ODOO_DB*Odoo database name
ODOO_USERNAME*Odoo login (email)
ODOO_PASSWORD*secretOdoo password or API key
Registryactive
Packageodoo-mcp
TransportSTDIO
AuthRequired
Resources1
Prompts5
Tools verifiedJun 10, 2026
UpdatedJun 10, 2026