odoo

This MCP server provides Claude with direct access to your Odoo ERP system by exposing a set of Odoo-integrated tools through the MCP protocol. It enables natural language queries to retrieve inventory data, purchase information, and manufacturing (MRP) details, with structured tool calls that map to Odoo XML-RPC endpoints. Available tools include inventory lookups (levels, product details), purchase order viewing and analytics, vendor information, BOM data, and manufacturing order management. To use it, configure your MCP client (e.g., Claude Cursor) to route requests to the odoo MCP server and invoke the available tools via natural language prompts; the system will translate those prompts into tool invocations and return results from Odoo.

Typical workflows include checking current stock levels, pulling recent purchase orders, examining BOMs for a product, and viewing manufacturing orders or work centers. For more advanced tasks, you can request production planning data or analytics reports, and the server will fetch the relevant information from Odoo and present it in a concise response.

Prerequisites:

• Go 1.21 or higher
• Access to an Odoo 17 instance
• Optional: PostgreSQL database for direct queries

1. Clone the repository and set up the project:

git clone <repository-url>
cd odoo-mcp-server
go mod tidy

2. Build the MCP server binary:

go build -o odoo-mcp-server

3. Configure the server by creating a config file based on the example and editing your Odoo connection details:

cp config.yaml.example config.yaml
vim config.yaml

Ensure the config contains fields such as:

odoo:
  url: "https://your-odoo-server.com"
  database: "your_database_name"
  username: "your_username"
  password: "your_password"

discord:
  webhook_url: "https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN"

webhook:
  port: "8080"
  enabled: true

4. Build additional components if needed (the repo may provide a build script):

./build.sh

5. Run the MCP server:

./odoo-mcp-server

Optional: test the webhook server if you use Discord notifications:

./odoo-webhook-server

Tips and considerations:

• Keep your Odoo credentials secure; the config.yaml holds sensitive data (username/password).
• If you enable the webhook for Discord notifications, ensure webhook_url is correct and reachable from the server.
• The MCP server exposes key tool functions: get_inventory_levels, get_product_info, get_purchase_orders, get_vendor_info, get_purchase_analytics, get_manufacturing_orders, get_bom_info, get_work_centers, and get_production_planning. Some operations (like create_inventory_adjustment, create_purchase_order, and create_manufacturing_order) may be in development or simplified; verify current capabilities in your deployed binary.
• If you enable PostgreSQL access, ensure proper network access and security controls.
• For best performance, consider running the server in a trusted network and restrict MCP access to authorized clients only.
• Logs and error handling are supported; check logs if a request fails to diagnose connectivity to Odoo or incorrect configurations.