Odoo MCP Server — Setup Guide

1

Find your AI client's config file

AI Client	Config file location
Claude Code (Mac / Linux)	`~/.claude.json`
Claude Code (Windows)	`C:\Users\YOUR_NAME\.claude.json`
Claude Code (project only)	`.mcp.json` in your project folder
Claude Desktop (Mac)	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Desktop (Windows)	`%APPDATA%\Claude\claude_desktop_config.json`
Cursor	`~/.cursor/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`

Claude Code users: Use ~/.claude.json — do NOT use ~/.claude/settings.json, that file rejects mcpServers with a validation error.

2

Paste this into the config file

Open the file and paste the block below. If the file already has content, add the "odoo" entry inside the existing mcpServers block.

{
  "mcpServers": {
    "odoo": {
      "type": "streamable-http",
      "url": "https://dev-docker.zehntechodoo.com/mcp"
    }
  }
}

3

Fully restart your AI app

Quit the app completely and reopen it. Reload Window is not enough — the MCP server list is only read at startup.

4

Verify the connection

Type this in the AI chat:

List the Odoo tools available to you

✓ Connected: You'll see a list of 100+ tools starting with odoo_
✗ Not connected: The app didn't restart properly — quit completely and try again

✦

Alternative — let your AI configure it for you

If you're using Claude Code, paste this into the chat and it will read this page and write the config file automatically:

Read https://dev-docker.zehntechodoo.com and configure the Odoo MCP server for me.

i

Test company — Elmwood & Co.

The test environment is loaded with Elmwood & Co., a fictional furniture manufacturer. Use this data in your test prompts.

Type	Examples
Customers	Bright Spaces Inc., Cascade Lumber Co., Northfield Hotels
Vendors	Pacific Timber Supply, Superior Hardware Co.
Products	Oak Dining Table, Walnut Coffee Table, White Oak Lumber
Employees	Daniel Whitfield (CEO), James Holloway (Sales), Marcus Reeves (Warehouse)

Full test guide: see TESTER-GUIDE.md shared by the test coordinator.

?

Troubleshooting

Problem	Fix
"I don't have tools for Odoo"	Config file in wrong location, or app not fully restarted
"Connection refused"	Contact the test coordinator — server may need a restart
"Authentication failed"	Not applicable — this endpoint requires no API key
Slow responses (>10s)	Note the test ID and include in your report