OdooWiki OCA HUB

Ai Oca Mcp

ai_oca_mcp folder_open OCA/ai open_in_new
Uncategorised License: AGPL-3

This module exposes Odoo AI tools as an MCP (Model Context Protocol) server, allowing external AI clients such as n8n or custom agents to call Odoo functions via the standardized MCP protocol. Authentication is handled via per-client API keys.

Note: Claude Desktop requires OAuth 2.0, which is not supported directly by this module. An extension could be required.

auto_awesome What this module does

AI-generated from the code · Odoo 16.0

Create MCP servers in Odoo that expose selected AI tools to external AI clients (like n8n or custom agents) through a secure web address, with per-client access keys and a full log of every request.

This module adds an "MCP Server" area under the AI menu. There you create a server record with a name, description and a list of AI tools to expose; only tools of the generic kind can be selected. Each server automatically gets a unique key and a ready-to-copy web address (URL) built from your Odoo base URL, which external AI clients call.

Access is controlled by security keys. From a server you can press "Add Key" to open a wizard that generates a random key, shown once for copying. Keys belong to a user, can have an expiration date, and can be expired manually with the "Expire Key" button; expired keys are greyed out. A scheduled check also expires keys whose expiration date has passed when they are used.

Every call is recorded in "MCP Server Log": the server, the key used, the date, the request, the response and any error. A "Show logs" button on the server form filters the log for that server.

Access rules limit normal users to their own keys and the servers those keys belong to, while administrators see everything. Logs are read-only for administrators.

Depends on

ai_tool
Models and fields (4)
  • mcp.server · new modelkey, url, name, active, key_ids (Access Keys), tool_ids (Tools), description
  • mcp.server.key · new modelname, state, user_id, server_id, expired_on, hashed_key, expiration_date
  • mcp.server.log · new modeldate, error, request, response, server_id, server_key_id
  • mcp.server.key.add · new modelkey (Key to use), key_id, server_id

Text generated by AI (DeepSeek) from reading the Odoo 16.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 1 confirmed, 8 with no information of 9 versions.

terminal Installation and usage

OCA documentation · Odoo 16.0

Usage

Source · Odoo 16.0
  • Access in Developer mode
  • Go to AI > MCP Server
  • Create a new MCP Server and add the generic tools you want to expose
  • Click Add Key to generate a new API key for a client — the key is only shown once
  • Use the provided URL and the generated key to configure your AI client

Connecting from n8n Use the MCP node with:

  • URL: the value shown in the URL field
  • Authentication: Bearer Token
  • Token: the generated API key

Tool limitations Only tools of kind generic are supported. Tools requiring a record context (generic_model, record) cannot be used via MCP.

Security Each client should have its own API key. Keys can be expired individually from the server form or from AI > MCP Server Log to audit all calls.

No verified information in OCA: Installation, Configuration.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.