odoo-devtools-mcp: An MCP Server for Odoo Development

Odoo development involves navigating a large and dynamic codebase: models, fields, views, XML, access rules, and business logic spread across multiple modules. While AI tools can help, they often lack real context from a running Odoo environment.

To address this gap, Heliconia Solutions built odoo-devtools-mcp, an MCP (Model Context Protocol) server that exposes Odoo development information directly to AI tools in a structured, reliable way.

This is not a replacement for Odoo knowledge or debugging skills. It is a context bridge.

What is odoo-devtools-mcp?

odoo-devtools-mcp is a Node.js–based MCP server that connects to an Odoo instance and exposes development-relevant information through MCP-compatible tools.

It allows AI assistants to query:

• Odoo models and fields
• Module structure and dependencies
• Views, actions, and technical metadata
• Code and configuration context

Instead of guessing, AI tools can now ask Odoo directly.

Why We Built It

AI tools are useful, but when working with Odoo they usually operate blind:

• They don’t know which fields exist on a model
• They don’t know which module defined a view
• They don’t know how your customizations differ from vanilla Odoo

This leads to:

• Incorrect code suggestions
• Outdated assumptions
• Time wasted validating AI output

odoo-devtools-mcp exists to solve this by providing live, structured context from the actual Odoo system you are working on.

What Problems It Solves

1. Model and Field Discovery

Instead of manually inspecting models or grepping code, AI tools can query:

• Available models
• Field definitions
• Field types and relations

2. Faster Debugging

When debugging issues, context matters:

• Which module introduced this field?
• Is this view inherited or overridden?
• Where is this behavior coming from?

The MCP server provides this information programmatically.

3. Safer AI Assistance

By grounding AI responses in real Odoo metadata, you reduce:

• Hallucinated APIs
• Invalid field references
• Incorrect inheritance assumptions

How It Works (High Level)

1. The MCP server connects to an Odoo instance
2. It exposes tools compliant with the Model Context Protocol
3. MCP-compatible AI clients can:
4. • Request model metadata
   • Inspect modules and views
   • Use this context when generating or reviewing code

The server does not modify data. It is focused on inspection and context.

Installation

Install the package using npm:

1
npm install -g odoo-devtools-mcp
Copy code

Configuration is done by pointing the server at your Odoo instance and credentials. Once running, it can be connected to any MCP-compatible AI tool.

(Refer to the README on npm for detailed setup instructions.)

Who This Is For

• Odoo developers working on custom modules
• Teams integrating AI into their development workflow
• Engineers who want faster insight into large Odoo installations
• Anyone tired of explaining their data model repeatedly to AI tools

This is especially useful for medium to large Odoo codebases where context switching is expensive.

What It Is Not

• It is not an AI replacement
• It does not auto-fix code
• It does not hide Odoo complexity

It simply makes the right information available at the right time.

Future Direction

We plan to expand coverage across:

• More Odoo internals
• Deeper view and inheritance inspection
• Improved developer workflows with AI tools

The goal is to keep the server boring, predictable, and useful — just like good infrastructure should be.

Conclusion

odoo-devtools-mcp is a small but practical tool: it gives AI assistants real visibility into Odoo systems.

If you work with Odoo and are experimenting with AI-assisted development, this bridges an important gap.

Project by Heliconia Solutions
Package: https://www.npmjs.com/package/odoo-devtools-mcp