odoo-claude-mcp

Overview

The odoo-claude-mcp is a comprehensive MCP server suite that transforms any Odoo instance into a first-class citizen in the Claude ecosystem. It exposes 197+ tools through the Model Context Protocol, offering not just Odoo integration but also complementary MCP servers for GitHub, filesystem, Portainer, Teams, and a web-based terminal. The suite supports multi-tenant deployments with unified authentication, making it suitable for teams, agencies, and SaaS providers. It includes specialized features like Bulgaria localization (НАП, ДДС, ЕИК), Qdrant vector store integration for semantic search, and Ollama integration for local LLMs.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• odoo_search_read

  Search and read Odoo records with filters

  Try:Show me all unpaid invoices this monthTry:Find customers in Sofia
• odoo_create

  Create new Odoo records

  Try:Create a new customer with name ABC CorpTry:Add a new product to the catalog
• odoo_write

  Update existing Odoo records

  Try:Update invoice INV-001 due date to next weekTry:Change product price to $99.99
• odoo_unlink

  Delete Odoo records

  Try:Delete draft quote Q-2023-001Try:Remove archived sales orders from 2022
• odoo_fields_get

  Get field definitions for an Odoo model

  Try:Show me all fields for the account.move modelTry:What fields are available for sale.order?
• odoo_execute

  Execute Odoo server methods

  Try:Run inventory valuation for all productsTry:Process all pending invoices
• odoo_attachment_upload

  Upload files as Odoo attachments

  Try:Upload contract.pdf to customer recordTry:Attach invoice.pdf to sale order
• odoo_translate_field

  Translate Odoo field values

  Try:Translate product description to GermanTry:Update Spanish translation for customer field
• ai_search_similar

  Find similar records using AI embeddings

  Try:Find similar products to 'Wireless Headphones'Try:Search for contracts like this one
• memory_write

  Store information in Claude's memory

  Try:Remember that our VAT rate is 20%Try:Note that client prefers email on Mondays
• odoo_web_login

  Authenticate to Odoo web interface

  Try:Log me into Odoo as adminTry:Access portal as customer john@example.com
• public_access_portal_orders

  Access customer portal orders

  Try:Show me portal orders for customer 42Try:Get recent portal orders for verification

Comparable tools

Installation

git clone https://github.com/rosenvladimirov/odoo-claude-mcp.git
cd odoo-claude-mcp

# Configure
cp .env.example .env
nano .env                    # set ODOO_URL, DB, credentials, tokens

# Create the shared Cloudflare tunnel network (one-time per host)
docker network create cloudflare-net

# Start the stack
docker compose up -d

# Verify
docker compose ps
curl http://localhost:8084/health

curl -fsSL https://raw.githubusercontent.com/rosenvladimirov/odoo-claude-mcp/2.0/install.sh | bash

iwr -useb https://raw.githubusercontent.com/rosenvladimirov/odoo-claude-mcp/2.0/install.ps1 | iex

claude mcp add odoo-mcp \
  --url https://your-domain.com/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

FAQ

What Odoo versions are supported?

The MCP server supports Odoo versions 15 through 19, with features tailored to each version's capabilities.

How does multi-tenancy work?

The stack supports multiple Odoo databases through a single MCP endpoint, with per-user profiles and connections allowing teams to manage multiple client databases from one authenticated session.

Compare odoo-claude-mcp with