Setup

1. Install the module
2. Add users to the MCP User group
3. Configure tool allowlists in MCP Server → Configuration
4. Connect your AI client (see Quick Connect below)

Quick Connect

Replace https://your-odoo.com with your Odoo instance URL.

Claude Code CLI:

claude mcp add odoo --transport http https://your-odoo.com/mcp
within claude cli use /mcp command and authenticate.

Claude Desktop / Claude.ai

Settings → Connectors → Add Custom Connector → Enter URL:

https://your-odoo.com/mcp

Browser opens for OAuth → Authorize → Ready

Guide: https://modelcontextprotocol.io/docs/develop/connect-remote-servers#connecting-to-a-remote-mcp-server

Gemini CLI

Edit ~/.gemini/settings.json:

{
  "mcpServers": {
    "odoo": {
      "url": "https://your-odoo.com/mcp"
    }
  }
}

within gemini cli, use /mcp command and authenticate

ChatGPT (Developer Mode)

In chatgpt settings → Apps menu → Advanced settings → Enable Developer Mode → Create app and add MCP server URL:

https://your-odoo.com/mcp

Browser opens for OAuth → Authorize → Ready

Guide: https://platform.openai.com/docs/guides/developer-mode

Requirements

• HTTPS required for production
• ripgrep (optional) - Faster code search

# Ubuntu/Debian
sudo apt install ripgrep

# macOS
brew install ripgrep

# Windows
choco install ripgrep

# Expose local Odoo via HTTPS tunnel
ngrok http 8069

# Use generated URL, set as web base url in system parameters: https://xxx.ngrok-free.app/mcp

Endpoints

• /mcp - MCP protocol endpoint
• /mcp/docs - Built-in documentation
• /.well-known/oauth-protected-resource - OAuth resource metadata
• /.well-known/oauth-authorization-server - OAuth server metadata

Multi-Database Support

For environments with multiple databases served from a single Odoo URL, the module supports path-based database routing.

Requirements

Add the module to server_wide_modules in your odoo.conf:

server_wide_modules = web,base,odoo_remote_mcp

Connection URLs

Use the database name in the URL path when connecting:

https://your-odoo.com/<database>/mcp

Examples

Claude Code CLI:

claude mcp add production --transport http https://your-odoo.com/production_db/mcp
claude mcp add staging --transport http https://your-odoo.com/staging_db/mcp

Gemini CLI (~/.gemini/settings.json):

{
  "mcpServers": {
    "odoo_production": {
      "url": "https://your-odoo.com/production_db/mcp"
    },
    "odoo_staging": {
      "url": "https://your-odoo.com/staging_db/mcp"
    }
  }
}

Path-based Endpoints

All endpoints support the database path prefix:

• /<database>/mcp - MCP protocol endpoint
• /<database>/mcp/docs - Built-in documentation
• /<database>/oauth/authorize - OAuth authorization
• /<database>/oauth/token - Token endpoint
• /.well-known/oauth-protected-resource/<database>/mcp - Resource metadata

Changelog

16.0.2.1.0 (Advanced ECharts)

Extensions & Custom JavaScript Support

• ECharts extensions: 4 popular extensions loaded by default (echarts-gl, wordcloud, liquidfill, stat)
• Pre-init JavaScript: code that runs before chart renders (registerMap, registerTheme, registerTransform)
• Post-init JavaScript: code that runs after chart renders (event handlers, drill-down, exports)
• New prompt templates: "3D Globe Command Center" and "Word Cloud Dashboard"
• Advanced tab in EChart form view for extension and JavaScript configuration
• CORS-friendly texture URLs documented for 3D globe visualizations

16.0.2.0.0 (Major Release)

ECharts Interactive Dashboards

• New create_echart tool for AI-generated dashboards using Apache ECharts
• Vibe coding for dashboards: describe what you want to visualize, AI builds it
• Blank canvas for AI: no rigid widgets, complete creative freedom
• No configuration lock-in: pure Python data code and JSON chart options
• Full data isolation support: toggle "Expose EChart Data in Tool Response" to keep data on server
• Flexible sharing: public links via secure tokens or internal user/group sharing
• Tool count increased from 11 to 12

16.0.1.1.2

• Improved transaction handling: tool execution now uses savepoints to rollback partial changes on failure
• Added full traceback logging to execution logs for easier debugging
• Defensive user_id capture before tool execution

16.0.1.1.1

• Fixed "Invalid access mode" error affecting Calendar and other views

16.0.1.1.0

• Added support for multi-database environments
• Minor fixes

16.0.1.0.0

Initial release