Odoo Semantic MCP — Install for your AI tool

Connect your AI coding tool to Odoo Semantic MCP to get real inheritance chains, field types, and view overrides — no more hallucinations. No API key yet? Sign up free or sign in.

Your API Key

Free & open source · MIT

Step 1 — Add the Viindoo marketplace (one-time)

claude plugin marketplace add Viindoo/claude-plugins --scope user

Step 2 — Install the MCP plugin (25 tools + 7 resources)

claude plugin install odoo-semantic-mcp@viindoo-plugins --scope user

Step 3 — Connect to the MCP server (prompts for URL + API key)

/odoo-semantic-mcp:connect

The command will prompt for your API key and server URL, then auto-configure permissions. Plugin is MIT-licensed and free forever — view on GitHub.

Optional — Supercharge with the free skills plugin →

Migrating from odoo-semantic-skills? It has been renamed to odoo-ai-agents. Simply run the command below to upgrade.

odoo-ai-agents (free forever) adds 41 skills · 7 agents · 9 commands on top of the MCP tools — fire from plain-English intent, no tool names to memorize. Also auto-pulls odoo-semantic-mcp if you skipped Step 2.

claude plugin install odoo-ai-agents@viindoo-plugins --scope user

Learn more about odoo-ai-agents →

Run in terminal

claude mcp add --transport http --scope user odoo-semantic \
  https://odoo-semantic.viindoo.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Skip permission prompts (optional)

Plugin users: /odoo-semantic-mcp:connect does this for you. Otherwise, merge into ~/.claude/settings.json so every mcp__odoo-semantic__* tool is auto-allowed:

~/.claude/settings.json

{
  "permissions": {
    "allow": ["mcp__odoo-semantic"]
  }
}

~/.codex/config.toml

[mcp_servers.odoo-semantic]
url = "https://odoo-semantic.viindoo.com/mcp"
http_headers = { "X-API-Key" = "YOUR_API_KEY" }

~/.gemini/settings.json

{
  "mcpServers": {
    "odoo-semantic": {
      "httpUrl": "https://odoo-semantic.viindoo.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" },
      "trust": true
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "odoo-semantic": {
      "type": "http",
      "url": "https://odoo-semantic.viindoo.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

▶ Install in VS Code

~/.gemini/antigravity/mcp_config.json

{
  "mcpServers": {
    "odoo-semantic": {
      "serverUrl": "https://odoo-semantic.viindoo.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

All plugins are MIT-licensed, free forever: github.com/Viindoo/odoo-mcp-client

Developer reference: Bootstrap & SCSS by Odoo version