MCP Odoo Bridge Server

Search for records in an Odoo model. Args: model: The Odoo model name (e.g., 'res.partner', 'sale.order') domain: Search filter as Odoo domain list (e.g., [['is_company', '=', True]]) Common operators: =, !=, >, <, >=, <=, like, ilike, in, not in fields: List of fields to return (empty = smart defaults) limit: Maximum records to return (default 80) offset: Number of records to skip (for pagination) order: Sort order (e.g., 'name asc, id desc') Returns: JSON list of matching records Examples: - Find all companies: model='res.partner', domain=[['is_company', '=', True]] - Find orders from this month: model='sale.order', domain=[['date_order', '>=', '2024-01-01']] - Find unpaid invoices: model='account.move', domain=[['payment_state', '!=', 'paid']]

Get a specific record by ID. Args: model: The Odoo model name record_id: The ID of the record to retrieve fields: List of fields to return (empty = all accessible fields) Returns: JSON object with the record data Example: Get customer details: model='res.partner', record_id=5

Count records matching a domain. Args: model: The Odoo model name domain: Search filter as Odoo domain list Returns: Number of matching records Example: Count unpaid invoices: model='account.move', domain=[['payment_state', '!=', 'paid']]

List all Odoo models available for MCP access. Returns: List of models with their permissions (read, create, update, delete)

Get field definitions for an Odoo model. Args: model: The Odoo model name field_types: Optional list of types to filter (e.g., ['many2one', 'char']) Returns: List of fields with their types and descriptions

Create a new record in Odoo. Args: model: The Odoo model name values: Dictionary of field values for the new record Returns: Success message with the new record ID Example: Create customer: model='res.partner', values={'name': 'New Customer', 'email': 'new@example.com'}

Update an existing record in Odoo. Args: model: The Odoo model name record_id: The ID of the record to update values: Dictionary of field values to update Returns: Success message Example: Update customer phone: model='res.partner', record_id=5, values={'phone': '123-456-7890'}

Delete a record from Odoo. Args: model: The Odoo model name record_id: The ID of the record to delete Returns: Success message ⚠️ WARNING: This action is irreversible!

Execute a custom method on an Odoo model. Args: model: The Odoo model name method: The method name to call record_ids: Optional list of record IDs to call the method on args: Positional arguments for the method kwargs: Keyword arguments for the method Returns: Method result ⚠️ Note: This requires special permission in Odoo settings. Example: Confirm sale order: model='sale.order', method='action_confirm', record_ids=[5]

Get the display name of a record (useful for looking up references). Args: model: The Odoo model name record_id: The record ID Returns: Display name of the record

Search and return the first matching record (convenience method). Args: model: The Odoo model name domain: Search filter as Odoo domain list fields: List of fields to return Returns: The first matching record or a message if not found