Connect Claude to Odoo

Claude connects to KMEE via MCP (Model Context Protocol) — Anthropic's native protocol for tool use. This gives Claude deeper, more natural access to your Odoo data.

Prerequisites: A KMEE account with an API key. See Getting Started.

Two connection modes

🌐 Claude Web (claude.ai)

MCP Streamable HTTP — works in the browser with Claude Pro/Team.

Recommended for teams

💻 Claude Code (CLI)

MCP stdio — runs locally, direct connection to your Odoo for developers.

Best for developers

Option A: Claude Web (MCP Streamable HTTP)

Connect Claude.ai to your Odoo through the KMEE Gateway MCP endpoint.

1. Get your MCP endpoint

MCP Endpoint url

https://gateway.kmee.ai/mcp

2. Configure in Claude.ai

Go to claude.ai → Settings → Integrations
Click "Add MCP Server"
Enter the URL: https://gateway.kmee.ai/mcp
Add header: X-API-Key: your-kmee-api-key
Click Connect

Claude will discover 11 MCP tools automatically:

Tool	Description	Example
search_read	Search and read records	Find customers in California
read_group	Aggregate data with grouping	Total sales by month
count	Count matching records	How many open invoices?
fields_get	Discover model fields	What fields does sale.order have?
list_models	List available models	Which modules are installed?
execute	Run model methods	Confirm a sale order (write access)
search_customers	Pre-optimized customer search	Find customer "Azure"
search_products	Pre-optimized product search	Search for "desk" products
search_invoices	Pre-optimized invoice search	Unpaid invoices over $1000
search_sales	Pre-optimized sales search	Sales orders this week
search_inventory	Pre-optimized inventory search	Low stock items

Option B: Claude Code (MCP stdio)

For developers using Claude Code (CLI), connect directly to your Odoo:

1. Add to your MCP settings

~/.claude/settings.json json

{
  "mcpServers": {
    "odoo": {
      "command": "uvx",
      "args": ["kmee-odoo-mcp-gateway"],
      "env": {
        "ODOO_URL": "https://mycompany.odoo.com",
        "ODOO_DB": "mycompany",
        "ODOO_USERNAME": "admin@mycompany.com",
        "ODOO_API_KEY": "your-odoo-api-key"
      }
    }
  }
}

2. Or use the gateway (multi-tenant)

~/.claude/settings.json (gateway mode) json

{
  "mcpServers": {
    "odoo-gateway": {
      "type": "url",
      "url": "https://gateway.kmee.ai/mcp",
      "headers": {
        "X-API-Key": "your-kmee-api-key"
      }
    }
  }
}

Difference: Direct mode (Option 1) connects to a single Odoo — simpler, no gateway needed. Gateway mode (Option 2) goes through KMEE with permissions, audit, and multi-tenant support.

Usage examples with Claude

Once connected, just ask Claude in natural language:

You:

"Show me all customers who ordered more than $10,000 this quarter"

Claude:

Uses read_group on sale.order grouped by partner_id, filtered by date and sum of amount_total > 10000. Presents a formatted table with customer names, order counts, and totals.

You:

"Create a summary of our inventory situation — highlight anything critical"

Claude:

Calls search_inventory to get all stock quantities, cross-references with reordering rules, identifies items below minimum stock, and creates a prioritized report with recommended actions.

You:

"Compare this month's sales with last month — by product category"

Claude:

Makes two read_group calls on sale.order.line for each month, groups by product category, calculates differences and percentages, presents a comparison table with growth indicators.

You:

"Find all overdue invoices and draft a follow-up email for each customer"

Claude:

Calls search_invoices with domain [state=posted, payment_state=not_paid, invoice_date_due < today], groups by customer, drafts personalized collection emails with invoice details and amounts.

Claude vs ChatGPT: which to use?

Criteria	ChatGPT	Claude
Protocol	REST / OpenAPI	MCP (native)
Setup	GPT Actions wizard	MCP server config
Tool discovery	Manual (OpenAPI import)	Automatic (MCP)
Multi-step reasoning	Good	Excellent
Code generation	Good	Excellent (Claude Code)
Team sharing	Easy (share GPT link)	Per-user MCP config
Best for	Non-technical users	Developers, analysts

Tip: Use the same KMEE API key for both. The gateway doesn't care which AI calls it — same permissions, same audit trail.

← ChatGPT Setup Next: Examples →