| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 3003 |
| Technical Name |
ms_claude_odoo |
| License | OPL-1 |
| Website | https://mountsol.com |
| Versions | 16.0 17.0 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 3003 |
| Technical Name |
ms_claude_odoo |
| License | OPL-1 |
| Website | https://mountsol.com |
| Versions | 16.0 17.0 18.0 19.0 |
MS Claude ↔ Odoo
Turn your Odoo into a Model Context Protocol server. Connect Claude Desktop, Claude Code, Cursor, Windsurf or any MCP client — and talk to your data in natural language.
Why Choose This Module?
Everything you need to expose your Odoo data to AI assistants — safely, auditable, and on your own terms.
|
🔒
User-Bound TokensEach token impersonates a real Odoo user. ACLs and record rules apply automatically — no parallel permission system to maintain. |
🛡
Three Roles
Read, Write, and Admin roles, each with a per-token model whitelist
and per-model method gating for |
📝
Full Audit TrailEvery call logged with arguments, latency, and outcome. Graph + pivot views ship out of the box under MS Analytics. |
|
⏱
Rate LimitingPer-token token-bucket throttle, default 60 calls / minute, configurable — or disabled entirely. |
📊
Live Dashboards
Build multi-tile dashboards from one natural-language prompt with
|
🌐
Multi-Worker SafeSessions live in Postgres — SSE GET and POST can land on different prefork workers without dropping state. |
14 Tools, One MCP Endpoint
A curated tool surface that covers everything an AI assistant needs to be useful in Odoo.
|
🔍
Discovery
|
📖
Read
|
📦
Compose
|
✏
Write
|
|
📄
Documents
|
🌐
Web
|
📈
Charts
|
💻
Dashboards
|
Provider-Agnostic
Works With Every MCP Client
We don't lock you to any one vendor. Use Claude Desktop,
Claude Code, Cursor, Windsurf, VS Code, or anything
else that speaks the Model Context Protocol. The |
|
|
🧠
Field-priority lists + composite tokenizers
|
Skills Bundle
5–10× Smaller PayloadsWe ship curated field-priority lists for 15 head models — so the AI sees what matters first, not every junk column. Composite packers fold a sale order with its lines, partner, invoices and deliveries into one tool call. Lower token cost. Cleaner answers. |
Built With Security First
|
🔑
Hashed StoragePlaintext shown once; only SHA-256 hashes persist. |
🏢
Multi-CompanyTokens respect company scoping. Multi-DB aware. |
🛡
SSRF Guard
|
🔗
Savepoint WritesWrite tools wrap each call in a Postgres savepoint — one bad call won't corrupt a session. |
How It Works
|
1
Install ModuleDrop the addon into your Odoo, install, and open MS Claude · Odoo from the apps drawer. |
2
Generate TokenConfiguration → Generate Token. Pick the user to impersonate, choose role & model whitelist, copy the plaintext. |
3
Wire Your Client
Point Claude Desktop / Code / Cursor at |
4
Ask Naturally“Show me sale orders over $5,000 confirmed this month.” Audit log captures every call. |
Step 1
Generate a TokenOpen MS Claude · Odoo → Configuration → Generate Token. Pick the user to impersonate, set the role and an optional model whitelist. |
|
|
Step 2
One-Time RevealThe plaintext token is shown exactly once. After that only the SHA-256 hash is stored — even an admin can't recover it. |
Step 3
Manage TokensBrowse, filter, revoke, or expire tokens from MS Tokens. Each row shows the impersonated user, role, last-used time, and current state. |
|
|
Step 4
General SettingsTune session timeout, rate limit, retention, and toggle whether tokens are required — all from Settings → MS Claude · Odoo. |
Step 5
Wire Up Your Client
Paste the MCP server URL and the bearer token into |
|
|
Step 6
Talk to Your DataAsk Claude natural-language questions. It picks the right tool, calls Odoo, and answers with the actual records — no SQL, no XML-RPC. |
Step 7
Audit Every CallEvery tool invocation lands in MS Audit Log with arguments, latency, outcome, and token. Investigate any session end-to-end. |
|
|
Step 8
Live AnalyticsOut-of-the-box graph and pivot views over the audit log — spot slow tools, hot models, and noisy clients in seconds. |
Step 9
Persistent Dashboards
Ask Claude to “build a sales dashboard” — |
|
|
Step 10
Curated SkillsEdit the system prompt and field-priority skills served to the assistant — teach Claude your Odoo's conventions in plain text. |
Sample Claude Desktop Config
{
"mcpServers": {
"ms-odoo": {
"command": "mcp-remote",
"args": [
"https://add_URL_here/mcp/sse?db=add_database_here",
"--transport", "sse-only",
"--header", "Authorization: Bearer add_token_here"
]
}
}
}
Client-Side Installation
On every laptop that wants Claude Desktop to talk to your Odoo, install Node.js, mcp-remote, and configure Claude. Pick your OS below.
|
💻
Windows Process Installation1. Install Node.jsOpen PowerShell as Administrator and run: winget install OpenJS.NodeJS.LTS Or download from nodejs.org and run the .msi installer. 2. Verify installnode --version npm --version 3. Install mcp-remotenpm install -g mcp-remote 4. Edit Claude Desktop configIn Run (Win + R) paste: %APPDATA%\Claude\claude_desktop_config.json Paste the JSON block above — with your Odoo URL, database name, and token. 5. Restart Claude DesktopRight-click the Claude tray icon → Quit, then reopen. |
🌍
Mac Process Installation1. Install Homebrew (if missing)/bin/bash -c "$(curl -fsSL \ https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 2. Install Node.jsbrew install node node --version npm --version 3. Install mcp-remotenpm install -g mcp-remote If you see 4. Edit Claude Desktop configmkdir -p ~/Library/Application\ Support/Claude open -e ~/Library/Application\ Support/Claude/\ claude_desktop_config.json Paste the JSON block above — with your Odoo URL, database name, and token. 5. Restart Claude Desktoposascript -e 'tell application "Claude" to quit' open -a "Claude" |
Why these three?
|
🟩
Node.jsJavaScript runtime — your computer can't run JS without it. |
📦
npm / npxComes with Node. Downloads & runs the bridge package. |
🔗
mcp-remoteBridges Claude Desktop (local pipes) to your Odoo (HTTPS). |
Technical Information
|
Odoo Version
19.0
|
License
OPL-1
|
Category
Productivity
|
Dependencies
base · mail · web
|
Need Help or Customization?
We're here to help with installation, role design, and any custom MCP tool requirements.
Visit mountsol.com →Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module