The Tool Catalog¶
The Tool Catalog is the menu of actions every connected AI client can call against your Odoo. It lives under and is seeded with 45+ ready-to-use tools at module install time.
Every entry is a row of type mcp.tool.ts with:
Tool Name — the technical identifier the AI client uses (
search_records,create_email_template…).Category — one of read, write, execute, workflow, chatter, event, advanced.
Risk Level — Low, Medium, or High. Drives the default approval policy and is displayed as a colour badge.
Description — natural-language description of what the tool does and when the AI should use it. This is the same text the AI sees in
tools/list.Input Schema — JSON Schema describing the tool’s arguments.
Active — toggle to globally enable or disable the tool.
Categories at a glance¶
Read — pull data out of Odoo (read records, search, describe model, list reports, knowledge search).
Write — create or update records, save dashboards and charts as Shared Pages, draft email templates.
Execute — fire Odoo methods (
execute_method) or send real test emails (send_test_email_template).Workflow — discover state transitions (
get_workflow_state) and trigger them (transition_state).Chatter — post messages on chatter (
post_message), schedule activities (schedule_activity), read activities (read_activities).Event — subscribe / unsubscribe to record-change events.
Advanced — compose dashboards, traverse relationships, build domains, etc.
Activating or deactivating a tool¶
Open .
Find the tool you want to change.
Use the Active toggle in the list, or open the form and click the Active / Inactive smart button.
Confirm the dialog (“Deactivate this tool? It will be removed from the AI’s tools/list catalog on the next refresh and any in-flight call will be rejected.”).
Tip
Disabling a tool at the catalog level is the strongest possible block — even an MCP Administrator’s connection cannot call it. For per-connection restrictions, use the Allowed Tools field on the Connection form instead.
Filtering and grouping¶
The Tools list view supports the standard search bar with filters:
Active / Inactive
Group by Category
Group by Risk Level
Defaults to “Active” so you see what’s live first.
Built-in tools at a glance¶
The module ships with the following tool families. The next pages dive into each one.
Data Tools (Read & Write) — read, search, create, update, delete, batch operations, build / validate domain.
Workflow Tools — discover and trigger Odoo workflows.
Chatter & Activity Tools — post messages and schedule activities on records.
Email Template Tools — draft, preview, test, and stage email templates and mass mailings.
Reporting & Analytics Tools — generate Odoo PDF / HTML reports, run the Pulse Report diagnostic, build dashboards and charts.