Odoo MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ODOO_URL | Yes | The URL of the Odoo instance (e.g., https://your-company.odoo.com) | |
| ODOO_API_KEY | Yes | The API key generated for the Odoo user | |
| ODOO_API_MODE | No | Protocol mode: 'auto' for automatic selection, 'xmlrpc' for Odoo 16-18, 'json2' for Odoo 19 | auto |
| ODOO_DATABASE | Yes | The Odoo database name | |
| ODOO_USERNAME | Yes | The Odoo user login (email) for the dedicated bot user | |
| ODOO_JOURNAL_PATH | No | Path to the local SQLite audit journal file | ~/.local/state/odoo-mcp/journal.sqlite3 |
| ODOO_ALLOW_MUTATIONS | No | Enable mutation preview and apply tools. Set to 'true' only after read-only testing. | false |
| ODOO_MAX_READ_RECORDS | No | Maximum number of records returned by read operations (default 100) | |
| ODOO_PLAN_TTL_SECONDS | No | Time-to-live for mutation preview tokens in seconds (default 300) | |
| ODOO_MAX_MUTATION_RECORDS | No | Maximum number of records affected by a mutation (default 20) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| odoo_connection_infoA | Check Odoo version, adapter, safety mode, and rollback scope. |
| odoo_search_readB | Read bounded Odoo records without exposing credentials or sensitive fields. |
| odoo_fields_getC | Inspect safe field metadata for an Odoo model. |
| preview_odoo_mutationC | Validate a create/write and return a short-lived, single-use preview token. |
| apply_odoo_mutationC | Apply an approved preview token, snapshot state, verify, and journal the change. |
| rollback_changeC | Rollback a journaled write or create performed through this MCP. |
| odoo_change_historyC | List local mutation audit entries without returning record contents. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool targets a distinct action: preview vs apply mutation, check connection, inspect fields, search records, view history, rollback. No overlaps.
Inconsistent naming: most tools start with 'odoo_' but two (apply_odoo_mutation, preview_odoo_mutation) embed 'odoo' in the middle, and rollback_change lacks the prefix entirely.
Seven tools is a well-scoped set for an Odoo integration covering connection, schema, search, mutations, history, and rollback.
Covers key mutation workflows (preview, apply, rollback) and supporting actions (search, fields, history). Minor gap: no direct delete or create without preview, but overall sufficient.