ivnvxd/mcp-server-odoo

Model Context Protocol (MCP) server that enables AI assistants to securely interact with Odoo ERP systems through standardized resources and tools for data retrieval and manipulation.

What it solves

This project provides a Model Context Protocol (MCP) server that allows AI assistants (like Claude) to interact directly with Odoo ERP systems. It enables users to manage business data—such as customers, products, and invoices—using natural language instead of navigating the Odoo interface.

How it works

The server acts as a bridge between an AI client and an Odoo instance. It connects via API keys or username/password authentication and supports two primary modes of operation:

  • Standard Mode: Requires the installation of a dedicated Odoo MCP module on the Odoo server for production-grade security and fine-grained access control over which models are accessible.
  • YOLO Mode: A development/testing mode that connects directly to Odoo's XML-RPC or JSON-2 APIs, bypassing the MCP module and security controls for quick prototyping.

It supports multiple transport protocols, including stdio for desktop apps and streamable-http for remote connectivity.

Who it’s for

Business users and developers who use Odoo ERP and want to integrate their business operations into an AI-powered workflow, allowing for natural language queries and data management.

Highlights

  • Full CRUD Capabilities: Search, retrieve, create, update, and delete Odoo records.
  • Server-side Aggregation: Perform grouping, summing, and counting without transferring raw data.
  • Workflow Actions: Ability to invoke public business methods (e.g., posting an invoice) via an opt-in escape hatch.
  • Smart Field Selection: Automatically identifies and returns the most relevant fields for a given model to optimize LLM output.
  • Resource Access: Fetch binary files, images, and documents via resource URIs.
  • Multi-company Support: Scope operations to specific companies in multi-company Odoo setups.

Related

  • Project
  • Project
  • Project
  • Project
  • Project