odoo_approval, odoo_system, and odoo_apps — system management, approval handling, and module operations

Admin Tools

Admin tools are reserved for MCP Server Administrator users. They manage the MCP server’s operational state: pending approvals, server configuration, and Odoo module lifecycle.

`odoo_approval`

Category: Admin | Policy: Admin group

Manages the approval queue for destructive or sensitive operations. Any odoo_unlink call and certain odoo_apps operations are placed in the queue rather than executed immediately.

Sub-Actions

`sub_action`	Description
`list_pending`	List all pending approval requests
`status`	Get the status and details of a specific approval request
`approve`	Approve and execute a pending operation
`reject`	Reject a pending operation (marks it as rejected, no action taken)

List All Pending Approvals

{
  "name": "odoo_approval",
  "arguments": {
    "sub_action": "list_pending"
  }
}

Response includes:

Approval ID
Operation type (e.g. unlink)
Model and record IDs affected
Requested by (user + client name)
Creation timestamp
Expiry timestamp

Approve an Operation

{
  "name": "odoo_approval",
  "arguments": {
    "sub_action": "approve",
    "approval_id": 7
  }
}

Reject an Operation

{
  "name": "odoo_approval",
  "arguments": {
    "sub_action": "reject",
    "approval_id": 7,
    "reason": "These records are still in use by finance team"
  }
}

`odoo_system`

Category: Admin | Policy: Admin group

Returns server configuration, user directory, and company information. Useful for diagnostics and for the AI to orient itself in the Odoo environment.

What It Returns

Data	Description
Server info	Odoo version, MCP module version, `web.base.url`
Config parameters	Selected `ai_integration.*` parameters
Users	List of active Odoo users with login, name, groups
Companies	All companies in the database

{
  "name": "odoo_system",
  "arguments": {
    "action": "info"
  }
}

{
  "name": "odoo_system",
  "arguments": {
    "action": "list_users"
  }
}

`odoo_apps`

Category: Admin | Policy: Admin group

Manages the Odoo module lifecycle — listing installed modules, searching, and queuing install/upgrade/uninstall operations.

[!WARNING] Module operations (install, upgrade, uninstall) are queued for human approval before execution. The AI cannot directly install or remove modules.

Sub-Actions

`sub_action`	Description
`list`	List all installed modules
`search`	Search available modules by name or keyword
`info`	Get details of a specific module
`queue_install`	Queue a module for installation (requires human approval)
`queue_upgrade`	Queue a module for upgrade
`queue_uninstall`	Queue a module for uninstall

Protected Modules

The following modules cannot be queued for uninstall — they are considered essential to Odoo or to the MCP server itself:

base  ·  web  ·  mail  ·  odoo_ai_mcp_server

List Installed Modules

{
  "name": "odoo_apps",
  "arguments": {
    "sub_action": "list",
    "state": "installed"
  }
}

Queue a Module Install

{
  "name": "odoo_apps",
  "arguments": {
    "sub_action": "queue_install",
    "module_name": "sale_management",
    "reason": "Customer requested CRM pipeline access"
  }
}

Admin Tools

On this page