Odoo MCP Server

MCP (Model Context Protocol) server for interacting with Odoo ERP. Enables AI assistants like Claude to read and write data across Odoo apps including Inventory, CRM, Sales, Manufacturing, and Purchases.

Repository: https://github.com/deeprunnerai/odoo-mcp-server

Quick Start

1. Clone and build

git clone https://github.com/deeprunnerai/odoo-mcp-server.git
cd odoo-mcp-server
npm install
npm run build

2. Configure Claude Code

Add to your Claude Code settings (~/.claude.json) under the mcpServers section.

Important: Replace the path with your actual clone location.

macOS/Linux:

{
  "mcpServers": {
    "odoo": {
      "type": "stdio",
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/Projects/odoo-mcp-server/dist/index.js"],
      "env": {
        "ODOO_URL": "https://odoo.deeprunner.ai",
        "ODOO_DB": "deeprunner",
        "ODOO_USERNAME": "your-email@deeprunner.ai",
        "ODOO_PASSWORD": "your-password"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "odoo": {
      "type": "stdio",
      "command": "node",
      "args": ["C:\\Users\\YOUR_USERNAME\\Projects\\odoo-mcp-server\\dist\\index.js"],
      "env": {
        "ODOO_URL": "https://odoo.deeprunner.ai",
        "ODOO_DB": "deeprunner",
        "ODOO_USERNAME": "your-email@deeprunner.ai",
        "ODOO_PASSWORD": "your-password"
      }
    }
  }
}

To find your path: After cloning, run pwd (macOS/Linux) or cd (Windows) in the odoo-mcp-server directory.

3. Restart Claude Code

After adding the config, restart Claude Code to load the MCP server.

Available Tools

Generic Tools

• odoo_search - Search records in any model
• odoo_read - Read specific records by ID
• odoo_search_read - Search and read in one call
• odoo_create - Create new records
• odoo_update - Update existing records
• odoo_delete - Delete records
• odoo_get_fields - Get field definitions for a model
• odoo_execute - Execute any model method

Inventory Tools

• inventory_list_products - List products with stock info
• inventory_get_stock - Get stock levels by product/warehouse
• inventory_list_warehouses - List all warehouses
• inventory_list_operations - List receipts/deliveries/transfers
• inventory_create_transfer - Create internal stock transfer

CRM/Sales Tools

• crm_list_leads - List CRM leads/opportunities
• crm_create_lead - Create new lead
• sales_list_orders - List sales orders
• sales_create_order - Create sales order
• sales_confirm_order - Confirm quotation

Contacts Tools

• contacts_list - List partners/contacts
• contacts_create - Create new contact

Manufacturing Tools

• manufacturing_list_orders - List manufacturing orders
• manufacturing_create_order - Create MO
• manufacturing_list_boms - List Bills of Materials

Purchase Tools

• purchase_list_orders - List purchase orders
• purchase_create_order - Create PO

Example Usage

Once configured, you can ask Claude things like:

• "List all products in the Air Quality Sensors category"
• "What's the current stock of AethAir Pro 500 across all warehouses?"
• "Create a sales order for Tesla with 10 units of the outdoor sensor"
• "Show me all pending manufacturing orders"
• "Create a new lead for a potential government contract"
• "How many users are there in Odoo?"

Common Odoo Models

Model	Description
product.product	Product variants
product.template	Product templates
stock.quant	Stock quantities
stock.picking	Inventory transfers
stock.warehouse	Warehouses
res.partner	Contacts/Partners
res.users	Users
sale.order	Sales orders
purchase.order	Purchase orders
crm.lead	CRM leads/opportunities
mrp.production	Manufacturing orders
mrp.bom	Bills of materials

Development

Run in development mode:

npm run dev

Build for production:

npm run build

License

MIT