List contacts
Search contacts (customers and vendors) by name, email or company.
MCP tool odoo_read → list_contacts
read
Returns contacts with their ID, name, email, phone and company. Use contact_id from each item for create_draft_invoice and create_sales_order. An empty result means no contact matches, which is the cue to call create_contact.
Parameters
| Name | Type | Description |
|---|---|---|
| query string | string | Text to match against name or email. |
| is_company boolean | boolean | true: only companies; false: only people. |
| limit integer | integer | 1 to 100. Default: 50. |
| offset integer | integer | Number of records to skip, for the next page. Default: 0. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "odoo_read",
"arguments": {
"operation": "list_contacts",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"items": [
{
"contact_id": 931,
"name": "Northwind Studio",
"email": "billing@northwind.example",
"phone": "+49 30 555 0142",
"is_company": true
}
],
"total": 1
},
"isError": false
}