Skip to main content
Glama
Odoo MCP Server

Odoo MCP Server

by dannyg-sys

Odoo MCP Server

License: MIT TypeScript MCP

An MCP (Model Context Protocol) server for managing Odoo development environments with AI assistants.

🎯 Overview

This MCP server provides 19 tools to manage Odoo development environments, allowing AI assistants to:

  • Control Odoo server (start, stop, restart, status)

  • Manage modules (update, install, test)

  • Switch between databases

  • Navigate project directories

  • View logs and configurations

Perfect for developers who want their AI assistants to remember and manage Odoo operations consistently across conversations.

Related MCP server: MCP Odoo Server

Architecture & the two surfaces

The management logic lives once, in src/core.ts, and is reached through two thin entry points plus a Claude Code skill:

src/core.ts    All Odoo logic + smart output filtering (single source of truth)
src/index.ts   MCP server  → for Claude Desktop        (build/index.js)
src/cli.ts     odoo-cli    → for Claude Code / terminal (build/cli.js)

Skills and MCP reach your machine through different doors, so each Claude surface uses the entry point that fits it:

Surface

How it reaches local Odoo

What it uses

Claude Desktop

a local MCP process it launches

the MCP server (build/index.js)

Claude Code

host shell access

the odoo-manage skill → odoo-cli

Why the split: a Claude Desktop skill runs sandboxed and cannot execute the local CLI, so Desktop needs the MCP (a real local process) to touch your Odoo install. Claude Code has host shell access, so a skill calling odoo-cli is the lighter option there — the 19 MCP tool schemas don't have to sit in context. Both paths run the same core.ts, including the identical output filtering.

The Claude Code skill lives at ~/.claude/skills/odoo-manage/SKILL.md (it calls build/cli.js, also installed as the odoo command). The orientation that Desktop needs is carried by the MCP itself — the odoo-help prompt and the tool descriptions — so no separate Desktop skill is required.

The stream capability — pull a remote nellika.sh / tcff Odoo database + filestore (over SSH, pg_dump | pg_restore and tar | tar, in parallel, no temp files) straight into the active local project — has a single implementation (the stream verb in manage_odoo.sh) exposed three ways: the odoo stream CLI command, the odoo_project action=stream MCP action, and a dedicated odoo-stream Claude Code skill. The skill is vendored under skill-stream/ (rendered to ~/.claude/skills/odoo-stream/ by the installer) and is just a thin wrapper that execs the engine verb. Local Postgres major must be ≥ the remote's (production is PG17).

The bash engine manage_odoo.sh is vendored at scripts/manage_odoo.sh and installed as the manage_odoo command; core.ts invokes it by absolute path and passes ODOO_BASE so it operates on the resolved base.

Environment layout this manages

  • Base (fixed): ~/odoo — holds the active odoo.conf and one odoo-<project>.conf per project. (Legacy location ~/git/odoo18 is used as a fallback until the base is moved.)

  • Sources live inside the base, _-prefixed so they stand out from the unprefixed project addon symlinks: _odoo18/ (CE 18), _enterprise18/ (EE 18), _odoo19/ (CE 19), _enterprise19/ (EE 19), plus _venv18/, _venv19/, and _data/.

  • 18 vs 19 is per-project, not a separate tree. The active odoo.conf selects it via its ; odoo_src / ; python_venv markers and addons_path. Switching project (odoo_switch_database / odoo switch) is what changes the running version — there is no version flag to set.

Features

  • Server Control: Start, stop, restart, and check status of Odoo server

  • Module Management: Update, install, and manage Odoo modules

  • Frontend Updates: Update frontend modules with automatic server restart

  • Testing: Run Odoo tests with optional filtering

  • Database Management: Switch between databases, list available databases

  • Backups & fresh DBs: Import a backup (.zip/.sql/.dump) or reset to a fresh DB

  • Production sync (stream): Stream a remote nellika.sh/tcff Odoo db+filestore (over SSH, in parallel, no temp files) into the active local project

  • Logging: Retrieve Odoo log entries

Installation

1. Install Dependencies

cd ~/git/odoo-mcp-server
npm install

2. Configure Claude Desktop

Add to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "odoo": {
      "command": "node",
      "args": ["/Users/dgoo2308/git/odoo-mcp-server/build/index.js"]
    }
  }
}

3. Restart Claude Desktop

The Odoo management tools will now be available in Claude.

Terminal commands (odoo / manage_odoo)

npm run setup (below) installs two commands into ~/.local/bin:

  • odoo — the smart front door (build/cli.js): same code as the skill/MCP, with output filtering and path helpers. Use this.

  • manage_odoo — the raw bash engine (scripts/manage_odoo.sh): same verbs, unfiltered output. Operates on $ODOO_BASE (default ~/odoo).

# examples
odoo status
odoo list
odoo switch verita
odoo update nell_thai_qr --error-only
odoo test purchase_dual_unit
odoo import ~/Downloads/backup.zip --neutralize   # drops+restores the active DB
odoo stream tcff_production_odoo --neutralize      # stream remote prod db+filestore into the active project
odoo logs --lines 200

Run odoo help for the full command list. Result text goes to stdout; [Executing]/[Success] diagnostics go to stderr. Options: --error-only, --tags <tags>, --lines <n>, --base <path> (default ~/odoo, fallback ~/git/odoo18).

Install everything (skill + commands)

install.sh installs all three pieces: the odoo-manage Claude Code skill, the odoo command, and the manage_odoo command.

cd ~/git/odoo-mcp-server
npm run setup        # or: ./install.sh

The installer builds build/cli.js if needed, renders the skill with the absolute path of this checkout (so it works no matter where the repo is cloned), and symlinks odoo / manage_odoo into ~/.local/bin. Re-run with --force to overwrite an existing skill file (./install.sh --force). Env: ODOO_BIN_DIR (default ~/.local/bin), CLAUDE_SKILLS_DIR (default ~/.claude/skills). Start a new Claude Code session to pick up the skill.

To set this up on another computer:

git clone https://github.com/dannyg-sys/odoo-mcp-server.git ~/git/odoo-mcp-server
cd ~/git/odoo-mcp-server
npm install && npm run build
npm run setup

Bootstrap a fresh Odoo base

npm run setup installs the tooling. To create the Odoo base itself on a new machine (the ~/odoo layout: clone CE 18/19 + Enterprise 18/19, build the per-version venvs, seed _data/_scripts/_concepts, the docs, and a sample config), run the environment bootstrap:

npm run setup-env        # or: ./scripts/setup_odoo_env.sh

Requires git, Python 3.10+, PostgreSQL, and GitHub access to the private odoo/enterprise repo (SSH key or HTTPS token). Env vars: ENTERPRISE_REMOTE=https, SKIP_ENTERPRISE=1, FULL_CLONE=1, PYTHON=python3.11, ODOO_BASE=/path. Idempotent — re-running skips what already exists.

Available Tools

The MCP exposes four tools, each taking an action (kept small so Claude Desktop reliably loads them all):

  • odoo_server — action: start | stop | restart | status | shell

  • odoo_modules — action: update | install | frontend | test (modules, testTags, errorOnly); output is filtered to errors/warnings

  • odoo_project — action: list | switch | new | import | fresh | stream (project, name, odooVersion, enterprise, modules, repo, httpPort, backupFile, remoteHost, remoteDb, remoteDataDir, dbOnly, filestoreOnly, neutralize, noStart). Destructive: import/fresh/stream drop the active DB; new creates the named DB.

  • odoo_info — action: logs | config-path | project-config | project-dir | addons-dir | enterprise-dir (project, lines)

The odoo-help prompt documents the same. (The CLI / odoo command keeps the full set of named subcommands — see "Terminal commands" above.)

Usage Examples

"Start Odoo"
"Update the purchase_dual_unit module"
"Install stock_account and hr modules"
"Run tests for the sale module"
"Switch to the nellika database"
"Stream tcff production into my local project and neutralize it"
"Show me the last 100 log lines"
"Where is the project directory for hhfbs?"
"What's the path to the Odoo core addons?"
"Show me the enterprise directory"

Configuration

Choosing the Odoo version

You normally don't. The Odoo version (18 vs 19) is selected per project by the active odoo.conf — switch project with odoo_switch_database (or odoo switch <project>) and the version follows. See Environment layout.

Using a different base directory

The base defaults to ~/odoo, falling back to ~/git/odoo18. To target a different base, pass an absolute path: the MCP tools accept a version argument and the CLI accepts --base <path>. The directory must look like an Odoo base (have an odoo.conf or at least one odoo-<project>.conf).

odoo status --base /path/to/some/base

After changing source, rebuild:

npm run build

Requirements

  • Node.js 16+

  • An Odoo base directory (~/odoo) with project configs; the manage_odoo.sh engine is installed by npm run setup

  • Claude Desktop (MCP) and/or Claude Code (skill + odoo command)

Development

# Build
npm run build

# Watch mode (auto-rebuild)
npm run watch

Troubleshooting

Server not found in Claude

  1. Check Claude Desktop config file path

  2. Ensure build directory exists: ls ~/git/odoo-mcp-server/build/

  3. Restart Claude Desktop completely

Commands failing

  1. Check the base path exists: ls ~/odoo (or the legacy ~/git/odoo18)

  2. Verify the engine is installed: command -v manage_odoo

  3. Check logs with odoo logs (or the odoo_get_logs MCP tool)

License

MIT

Available Tools

4 tools
odoo_infoB

Inspect the active project. action: logs (tail the full odoo.log) | config-path | project-config | project-dir | addons-dir (active core source: _odoo18 or _odoo19) | enterprise-dir.

Inputs: action (required), lines, project.

odoo_modulesA

Update/install/test Odoo modules in the active project. action: update | install | frontend | test. 'modules' is a comma-separated list (required for update/install/frontend; optional for test = all). Output is filtered to errors/warnings; use odoo_info action=logs for the full log.

Inputs: action (required), modules, testTags, errorOnly.

odoo_projectA

Manage projects and their databases. action: list (projects + active one) | switch (activate odoo-.conf and restart; also changes the running Odoo 18/19) | new (scaffold a new project) | import (load a backup into the active DB) | fresh (reset the active DB to a fresh one initialized with base, + 'modules') | stream (stream a remote nellika.sh/tcff Odoo db+filestore over SSH into the active project). DESTRUCTIVE: import/fresh/stream drop the active DB; new creates/recreates the named DB.

Inputs: action (required), name, repo, dbOnly, +12 more.

odoo_serverA

Control the Odoo server for the active project. action: start | stop | restart | status | shell (shell prints the command to open an interactive shell).

Inputs: action (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 4 tools

    Disambiguation4/5

    The four tools are split into clearly distinct domains: server control, module operations, project inspection, and database/project management. Mild overlap remains because odoo_project=switch performs a restart and odoo_modules refers to odoo_info=logs for full output, but the descriptions prevent serious confusion.

    Naming Consistency5/5

    All tool names follow the same odoo_<noun> snake_case pattern, making the namespace easy to predict. The subactions are lowercase and consistent enough within each tool.

    Tool Count5/5

    Four tools is within the ideal range and each tool represents a meaningful high-level area of Odoo work. No tool feels redundant; the small count keeps the surface navigable while covering server, module, info, and project concerns.

    Completeness4/5

    Core workflows are covered: starting/stopping the server, updating/installing/testing modules, inspecting logs/config, and managing project databases. Obvious gaps include no module scaffolding, no project deletion, and no database export/backup, but these are workable edge cases rather than core dead ends.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables AI agents to interact with Magento 2 development environments through comprehensive tools for module management, database operations, cache control, configuration management, and system diagnostics. Supports complete development workflows from module creation to deployment and troubleshooting.
      28
      178 npm
      41
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with Odoo databases via XML-RPC and JSON-RPC for performing CRUD operations and managing modules. It supports advanced features like domain-based searching, field metadata inspection, and administrative task execution.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An Odoo module that embeds an MCP server, enabling AI agents to directly access Odoo capabilities such as terminal control, database operations, filesystem management, ORM execution, and service administration.
      4
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to fully control and manage Odoo 18 ERP instances through 79 tools, including configuration, data operations, reporting, and code generation, with built-in domain knowledge and specialist agents.
      5
      AGPL 3.0