Odoo Mcp Client

Odoo MCP Client

[](LICENSE) [](https://odoo-semantic.viindoo.com/)

> 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-intakefront door"]
        wfrunner["workflow-chainingYAML executor"]
        skills["odoo-ai-agents53 skills / 24 agents / 8 commands"]
        fp["odoo-forward-portforward-port pipeline"]
        mcp["odoo-semantic-mcpMCP connection"]
        intake --> wfrunner --> skills
        intake --> skills
        skills --> fp
        skills -. depends on .-> mcp
        fp -. depends on .-> mcp
    end

    server["OSM MCP Server (AGPL-3.0)25 tools / 7 resources · Odoo v8+"]
    out["Answer in chat or .odoo-ai/"]

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

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/](plugins/). Each has its own detailed README - start there for usage, install, and reference:

| Plugin | What it is | README | |--------|-----------|--------| | [odoo-ai-agents](plugins/odoo-ai-agents/) | The full Odoo AI workforce toolkit: 53 skills + 24 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](plugins/odoo-ai-agents/README.md) | | [odoo-semantic-mcp](plugins/odoo-semantic-mcp/) | The thin MCP connection layer: registers the odoo-semantic server (25 tools / 7 resources) and ships the /odoo-semantic-mcp:connect command. Install this alone for raw MCP tools only. | [README](plugins/odoo-semantic-mcp/README.md) | | [git-toolkit](plugins/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](plugins/git-toolkit/README.md) |

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_, 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](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](LICENSE) and [NOTICE](NOTICE). Brand assets in branding/ are trademarks of Viindoo Technology JSC and are not covered by the MIT grant - see [branding/TRADEMARK.md](branding/TRADEMARK.md).

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Viindoo
• Source: Viindoo/odoo-mcp-client
• License: MIT
• Homepage: https://odoo-semantic.viindoo.com/

Install and usage instructions live in the source repository linked above.