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

ToolsPurpose
search, fetchSearch and fetch instance playbook, glossary, and model guidance documents.
odoo_health, odoo_system_info, odoo_whoami, odoo_diagnosticsConfirm server, identity, scopes, endpoint, and effective setup.
odoo_instance_guide, odoo_semantic_glossary, odoo_resolve_questionTranslate business language into likely Odoo models, fields, filters, and ambiguity notes.
odoo_list_models, odoo_get_access_rights, odoo_model_fieldsDiscover 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

PromptUse
safe_odoo_readResolve a business question and inspect only exposed models and allowed fields.
safe_odoo_updatePerform diagnostics and metadata checks before an explicit write.
odoo_inventory_checkInvestigate products, warehouses, stock, moves, and replenishment signals.
odoo_sales_assistantInvestigate 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

  1. Ask the client to identify itself with odoo_whoami.
  2. Resolve the business question with odoo_resolve_question.
  3. Inspect model access and fields before reading or writing.
  4. Use a narrow domain and explicit fields.
  5. 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.