# Odoo Mcp Client

> MIT-licensed Claude Code plugin + IDE snippets for the Odoo Semantic MCP server (Viindoo).

- **Type:** MCP server
- **Install:** `agentstack add mcp-viindoo-odoo-mcp-client`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Viindoo](https://agentstack.voostack.com/s/viindoo)
- **Installs:** 0
- **Category:** [Search](https://agentstack.voostack.com/c/search)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Viindoo](https://github.com/Viindoo)
- **Source:** https://github.com/Viindoo/odoo-mcp-client
- **Website:** https://odoo-semantic.viindoo.com/

## Install

```sh
agentstack add mcp-viindoo-odoo-mcp-client
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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](https://odoo-semantic.viindoo.com/) 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`](https://odoo-semantic.viindoo.com) -
> API key and install guide: [`/install`](https://odoo-semantic.viindoo.com/install/)

```mermaid
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](https://odoo-semantic.viindoo.com/install/) 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](https://odoo-semantic.viindoo.com/install/)
- 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:

```bash
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](https://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](https://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](https://github.com/Viindoo)
- **Source:** [Viindoo/odoo-mcp-client](https://github.com/Viindoo/odoo-mcp-client)
- **License:** MIT
- **Homepage:** https://odoo-semantic.viindoo.com/

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-viindoo-odoo-mcp-client
- Seller: https://agentstack.voostack.com/s/viindoo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.