Skip to Content

Troo Claude Integration | Odoo MCP Server

by
Odoo
v 19.0 Third Party 1
Download for v 19.0 Deploy on Odoo.sh
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Lines of code 1080
Technical Name troo_mcp_server
LicenseAGPL-3
Websitehttps://www.quixom.com
Versions 17.0 18.0 19.0
You bought this module and need support? Click here!
Availability
Odoo Online
Odoo.sh
On Premise
Odoo Apps Dependencies Discuss (mail)
Lines of code 1080
Technical Name troo_mcp_server
LicenseAGPL-3
Websitehttps://www.quixom.com
Versions 17.0 18.0 19.0

Troo MCP Server for Odoo

Connect Claude Web, Cursor AI, Claude Desktop, and other MCP-capable assistants to your Odoo data. Users can ask in plain English, while administrators control exactly which users, models, actions, and fields are available.

Claude Web
Connector URL
Cursor AI
JSON + Headers
Per User
Model Access
Audit Ready
Logs & Limits

What This Module Does

Troo MCP Server exposes a secure MCP endpoint at /troo/mcp. AI clients authenticate with Odoo API keys, then use controlled MCP tools such as check_mcp_access, search_read, create_record, write_record, call_method, and admin-only list_models.

Two Connection Styles

Claude Web and custom connectors can use a full URL with database and API key. Cursor AI and similar clients can use generated JSON with URL and HTTP headers.

Layered Security

A user must have Troo MCP User or Troo MCP Administrator access. Standard users must also have an active model rule and matching permission for the requested operation.

Native Odoo Rules

The final read, create, update, and method calls run as the authenticated Odoo user, so normal ACLs and record rules continue to apply.

Operational Control

Enable or disable the MCP server globally, limit read size, control delete availability, track request activity, and apply rate limits per user.

Configuration Flow

Configure Odoo first, then connect the AI client. The module provides both the Claude Web URL and generated JSON for clients that support headers.

1. Configure MCP in Odoo

1 Go to Troo MCP > Configuration > Settings and enable MCP Access.
2 Set the public base URL, for example your HTTPS domain, and confirm the database name.
3 Generate an API key from the Odoo user profile, copy it into Your API Key, and use the generated Claude Web / Custom Connector URL.
4 Give the API-key owner Troo MCP User access. Use Troo MCP Administrator only for trusted administrators.
5 Activate the target model for the user, such as res.partner, and enable the exact permissions needed: Read, Create, Update, Delete, or Call Method.

2. Configure Claude Web

Copy the generated Claude Web / Custom Connector URL from Odoo, then add it as a custom connector in Claude Web.

https://your-domain.com/troo/mcp?db=your_database&api_key=YOUR_KEY
1 Open Claude Web and go to Settings > Connectors.
2 Click Customize, click +, then choose Add custom connector.
3 Paste the generated URL into Remote MCP Server URL, enter a connector name, and click Add.
4 After the connector loads, you should see 6 active tools available for the connected Odoo MCP server.

3. Configure Cursor AI

Use the generated JSON configuration from Odoo and paste it into Cursor's MCP settings.

{ "mcpServers": { "Troo-Odoo": { "url": "https://your-domain.com/troo/mcp?db=your_database", "headers": { "Authorization": "Bearer YOUR_KEY", "X-Odoo-Database": "your_database" } } } }
1 Open Cursor AI and press Ctrl + Shift + P.
2 Search for Cursor Settings: Tools & MCPs and open it.
3 Click Add Custom MCP and paste the auto-generated JSON content from Odoo.
4 Press Ctrl + S to save. The server should connect and show 6 enabled tools.

Claude Web + Cursor AI Configuration with Odoo (MCP Demo)

In this video, we are configuring Claude Web and Cursor AI with Odoo using MCP. The setup demonstrates how MCP tools such as create_record are used to send data to Odoo.

Watch Full Configuration Video (Google Drive)

Configuration & Demo Screenshots

Step 1 - Configure MCP in Odoo

Enable MCP Access in the Troo MCP configuration.

Set the default database if required. The MCP endpoint URL is generated automatically using your Odoo instance's current domain (web.base.url), so no manual public URL configuration is needed.

Generate an API Key for the user:
Go to My Profile → Account Security → New API Key.
Create a new API key and copy the generated value.

Paste the generated API key into the Your API Key field.

The Claude Web / Custom Connector URL will be generated automatically using:
• Your Odoo domain
• The selected database
• The API key

For Claude Web or custom connectors, copy the generated Claude Web / Custom Connector URL.

For Cursor or Claude Desktop, copy the Auto-Generated Configuration (JSON) and replace [[PASTE_YOUR_API_KEY_HERE]] with your generated API key.

MCP settings configuration in Odoo
MCP settings configuration in Odoo

Step 2 - Configure Claude Web

Use the connector URL generated by the module.
In Claude Web, go to Settings → Connectors → Add → Add Custom Connector. Paste the generated URL into the Remote MCP Server URL field, enter a connector name, and click Add to complete the setup. The URL already includes the endpoint, database, and API key.

MCP settings configuration in Odoo

Step 3 - Configure Cursor AI

In Cursor, open Settings → Tools & MCPs, or press Ctrl + Shift + P and search for Tools & MCPs. Click Add Custom MCP to open the MCP configuration file. Copy the generated content from the module's Auto-generated Config (JSON) field and paste it into the mcp.json file. Save the file using Ctrl + S to complete the setup and connect Cursor AI to Odoo through MCP.

Cursor AI MCP configuration connected to Odoo

Step 4 - Assign Active Models and Permissions

After completing the MCP configuration, grant the user access to the required Odoo models. If the Troo MCP Server user has Administrator access rights, it can access all Odoo models that the user already has permission to access, and no additional configuration is required in the Troo MCP tab. If the Troo MCP Server user has regular User access rights, you must explicitly add each active model (for example, Contacts: res.partner) and enable only the actions the AI should be allowed to perform, such as Create, Read, Write, or Delete. Only models added to the Active Models list will be available through MCP.

MCP active model list
MCP active model permissions

Claude Web Testing

After completing the configuration, you can verify that the MCP connection is working correctly. In this example, the user asks Claude Web to create a contact. Claude invokes the MCP create_record tool, and the new contact is successfully created in Odoo.

Claude Web creating a contact through MCP

Odoo Response

The created contact appears in the Contacts list, and the MCP activity can be audited from the module logs.

Contact created in Odoo through MCP

Audit Log

Monitor all MCP activity from a centralized audit log. Each entry records key details such as the user, model, method, request summary, response summary, status, and timestamp. In this example, the log shows that a contact was successfully created, including information about when the action occurred, which user performed it, the target model (res.partner), and the operation status.

MCP activity audit log

In this example, the user asks Claude Web to create a customer invoice based on the attached invoice. Claude invokes the MCP create_record tool, and the new invoice is successfully created in Odoo. If the customer or product is missing, it is automatically created before generating the invoice.

Claude Web creating an invoice through MCP

Odoo Response

The newly created invoice appears in Odoo Accounting, confirming that the MCP request was processed successfully. The invoice details can be reviewed in Odoo, and the complete operation is recorded in the MCP activity logs for auditing.

Invoice created in Odoo through MCP

In this example, the user asks Claude Web to confirm the newly generated invoice with a $27 down payment.

Claude Web invoice confirmation with MCP

Odoo Response

We can see the generated invoice has been moved to the “Confirmed” state with a partial payment of $27 applied. The updated status is reflected in Odoo Accounting, confirming the successful workflow execution via MCP.

Invoice confirmed in Odoo with partial payment via MCP

Security Behavior

Understand how access is enforced based on Troo MCP roles and Odoo security permissions.

No MCP Group

The request is blocked even if the target model is active for the user. Users must belong to Troo MCP User or Troo MCP Administrator.

Troo MCP User

The module checks active models and per-model permissions before running the requested tool as that Odoo user.

Troo MCP Administrator

Administrators can list models and bypass the active-model whitelist. Standard Odoo access rules still protect the actual ORM operation.

Frequently Asked Questions

Why does the AI not see my Odoo tools?
Confirm MCP Access is enabled, the public URL is reachable, the API key is valid, and the AI client was reconnected after configuration changes.
Why is record creation denied?
The user needs Troo MCP User access, an active access rule for the requested model, Create permission on that rule, and the required Odoo create permissions for the record being created.
Which connection format should I use?
Use the full connector URL for Claude Web and custom connector screens. Use JSON with headers for Cursor AI and clients that support remote MCP server configuration files.
How do I verify access before running commands?
Ask the AI to run check_mcp_access. It returns whether the user is an MCP administrator or which active models and permissions are available.

Our Services

End-to-end Odoo services to help you customize, integrate, migrate, and scale your business operations.

⚙️

Odoo Customization

Tailoring Odoo to fit your unique business requirements.

🔗

Odoo Integration

Seamlessly connect Odoo with your existing business systems.

📋

Odoo Migration

Smooth transition between Odoo versions and environments.

🛟

Odoo Support

Reliable assistance and maintenance for your Odoo platform.

👨‍💻

Hire Odoo Developer

Access experienced Odoo developers for your projects.

🚀

Odoo Implementation

Transform business processes with successful Odoo deployments.

Our Offerings

Beyond Odoo, we help businesses build innovative digital solutions and modern technology platforms.

01

Digital Product Design

Create intuitive user experiences and products customers love.

02

AI & ML Services

Leverage artificial intelligence and machine learning for smarter business decisions.

03

Data Science

Unlock insights and improve decision-making through advanced analytics.

04

Custom Software Development

Build scalable applications tailored to your business goals.

05

Cloud Engineering & DevOps

Accelerate deployment and cloud operations with certified experts.

06

Mobile App Development

Deliver engaging iOS and Android experiences for your customers.

Need Help or Have Questions?

We're here to help. If you have any questions, need customization, or require support, feel free to contact us.

Request a Demo

sales@quixom.com

Visit Website

www.quixom.com

Follow Us

Please log in to comment on this module

  • The author can leave a single reply to each comment.
  • This section is meant to ask simple questions or leave a rating. Every report of a problem experienced while using the module should be addressed to the author directly (refer to the following point).
  • If you want to start a discussion with the author, please use the developer contact information. They can usually be found in the description.