Use MCP
MCP Tools, Prompts, Resources, and Example Requests
Understand the tool categories exposed to AI, built-in prompts and resources, and safe example requests for common Odoo workflows.
Tool discovery is dynamic. A client sees only tools that remain valid for its credential scopes, connected user, available model permissions, and bundle tool controls.
Discovery and guidance
| Tools | Purpose |
|---|---|
| search, fetch | Search and fetch instance playbook, glossary, and model guidance documents. |
| odoo_health, odoo_system_info, odoo_whoami, odoo_diagnostics | Confirm server, identity, scopes, endpoint, and effective setup. |
| odoo_instance_guide, odoo_semantic_glossary, odoo_resolve_question | Translate business language into likely Odoo models, fields, filters, and ambiguity notes. |
| odoo_list_models, odoo_get_access_rights, odoo_model_fields | Discover exposed models and inspect effective permissions and safe field metadata. |
Record and analytics tools
- Read: odoo_name_search, odoo_search, odoo_read, odoo_browse, odoo_count, odoo_get_messages.
- Analytics: odoo_read_group, odoo_pivot, odoo_timeseries, odoo_topn, odoo_funnel, odoo_cohort.
- Exports: odoo_export_csv and odoo_export_dataset for CSV, JSON, or XLSX.
- Mutations: odoo_create, create_res_partner_contact, odoo_write, odoo_post_message, and odoo_delete.
- Batch: batch_search, batch_create, batch_update, and batch_delete.
Asynchronous and application tools
- odoo_submit_bulk_job, odoo_get_bulk_job, odoo_cancel_bulk_job, and odoo_get_bulk_job_result.
- odoo_list_dashboards, odoo_create_dashboard, odoo_update_dashboard, and odoo_delete_dashboard.
- Administrator-only module tools: odoo_list_generated_modules, odoo_build_data_module, and odoo_install_data_module.
Built-in prompts
| Prompt | Use |
|---|---|
| safe_odoo_read | Resolve a business question and inspect only exposed models and allowed fields. |
| safe_odoo_update | Perform diagnostics and metadata checks before an explicit write. |
| odoo_inventory_check | Investigate products, warehouses, stock, moves, and replenishment signals. |
| odoo_sales_assistant | Investigate customers, quotations, sales orders, activities, and follow-up context. |
Built-in resources
- odoo://guide — instance playbook, glossary, and exposed-model guidance.
- odoo://models — current exposed models and permissions.
- odoo://health — endpoint health.
- odoo://diagnostics — setup and connection diagnostics.
Safe request pattern
- Ask the client to identify itself with odoo_whoami.
- Resolve the business question with odoo_resolve_question.
- Inspect model access and fields before reading or writing.
- Use a narrow domain and explicit fields.
- For a write, request an explanation and explicit IDs before execution.
Example business prompts
Show open quotations older than 14 days. Explain the model and filter first, then return customer, quotation number, date, salesperson, total, and status. Do not modify records.Summarize posted customer invoices by customer for the current quarter. Use governed aggregation instead of loading every invoice.Find pending incoming receipts for the main warehouse and group them by vendor and scheduled week.Connect Claude, Cursor, Codex, and Automation Clients
Connect Claude with OAuth, configure Cursor through mcp.json, and use scoped API keys for Codex, n8n, scripts, and other MCP clients.
Connections, Audit Logs, and Asynchronous Jobs
Monitor connected clients, investigate MCP activity, disable credentials, and manage persisted count or export jobs.
