Odoo MCP Client

odoo-mcp-client is the MIT-licensed client layer that brings the Odoo Semantic MCP server into your AI agent as an Odoo workforce toolkit - covering engineering, sales, marketing, strategy, onboarding, and visual UI testing. Hosted instance: odoo-semantic.viindoo.com - API key and install guide: /install

flowchart TD
    You["You - plain-language intent"]

    subgraph client["odoo-mcp-client (MIT)"]
        intake["odoo-intake<br/>front door"]
        wfrunner["workflow-chaining<br/>YAML executor"]
        skills["odoo-ai-agents<br/>52 skills / 26 agents / 8 commands"]
        fp["odoo-forward-port<br/>forward-port pipeline"]
        mcp["odoo-semantic-mcp<br/>MCP connection"]
        intake --> wfrunner --> skills
        intake --> skills
        skills --> fp
        skills -. depends on .-> mcp
        fp -. depends on .-> mcp
    end

    server["OSM MCP Server (AGPL-3.0)<br/>31 tools / 9 resources · Odoo v8+"]
    out["Answer in chat or $ODOO_AI_HOME"]

    You --> intake
    You -. "skill fires directly" .-> skills
    skills --> server
    mcp --> server
    server --> out

Loading

All knowledge and computation live on the OSM server; this repo is a thin routing and orchestration layer.

What is in this repo

This is a monorepo of three Claude Code plugins under plugins/. Each has its own detailed README - start there for usage, install, and reference:

Plugin	What it is	README
odoo-ai-agents	The full Odoo AI workforce toolkit: 52 skills + 26 agents + 8 commands across 9 personas, plus 13 declarative workflows and the drive-to-done orchestration harness. Includes instance lifecycle ops (create/drop/init/update/run-tests for any Odoo series v8+). Depends on odoo-semantic-mcp (auto-installed).	README
odoo-semantic-mcp	The thin MCP connection layer: registers the odoo-semantic server (31 tools / 9 resources) and ships the /odoo-semantic-mcp:connect command. Install this alone for raw MCP tools only.	README
git-toolkit	A domain-agnostic, Apache-2.0 git + GitHub toolkit for AI agents: one front-door skill (git-ops) + 4 agents that run git/github work safely in a delegated context - never losing code, scaling to thousands of files. Depends on the github plugin (auto-installed). No Odoo dependency.	README

Most users install odoo-ai-agents, which pulls in odoo-semantic-mcp automatically as a declared dependency - the skills, agents, commands, and the MCP connection all arrive in one step.

Quick install (Claude Code)

Full toolkit (recommended) - skills + agents + commands + MCP, in three steps:

/plugin marketplace add Viindoo/claude-plugins   # one-time, if not already registered
/plugin install odoo-ai-agents@viindoo-plugins   # auto-pulls odoo-semantic-mcp
/odoo-semantic-mcp:connect

MCP-only - if you only want the MCP tools (no persona skills/agents/commands):

/plugin install odoo-semantic-mcp@viindoo-plugins
/odoo-semantic-mcp:connect

Either way, restart Claude Code afterward so the MCP tools load. You will need an API key (format osm_...) from the install page and the MCP server URL (default https://odoo-semantic.viindoo.com/mcp). Per-plugin install notes, browser MCP setup, and other-AI-tool configs are in each plugin's README.

Requirements

• Odoo Semantic MCP server URL - https://odoo-semantic.viindoo.com/mcp (or your self-hosted instance)
• API key - format osm_<alphanumeric>, obtain from the install page
• Claude Code with MCP support (v2.1.x or newer)

For contributors - local dev install

Prerequisite: Python 3.12+ (needed by make setup / make test).

Test changes from a checkout without going through the marketplace. Each plugin lives under plugins/ - point --plugin-dir at the one you are working on:

claude --plugin-dir ./plugins/odoo-ai-agents   # skills + agents + commands
claude --plugin-dir ./plugins/odoo-semantic-mcp      # MCP connection + connect command
claude --plugin-dir ./plugins/git-toolkit            # git/github toolkit (skill + agents)

See CONTRIBUTING.md for the full plugin-dev workflow, the release / SHA-pinning pipeline, and the DCO sign-off requirement.

Relationship to the server

Layer	Repository	License
Client (this repo) - plugins, skills, agents, snippets	Viindoo/odoo-mcp-client	MIT
Server - indexer, Neo4j graph, pgvector, MCP server, web UI	odoo-semantic.viindoo.com	AGPL-3.0-or-later

To use the hosted instance, sign up for an API key at odoo-semantic.viindoo.com/install. Self-hosting instructions are available in the server's own documentation, accessible after registration.

License

MIT - see LICENSE and NOTICE. Brand assets in branding/ are trademarks of Viindoo Technology JSC and are not covered by the MIT grant - see branding/TRADEMARK.md.