Odoo MCP

Самостоятельный MCP-сервер для Odoo: чтение и защищенная запись данных ERP через агента, любая редакция и версия

MCP-сервер

Высокий риск

Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

Почему такой уровень

  • Подключается к базе Odoo по учетным данным
  • Может записывать изменения в данные ERP
  • Работает с производственными системами
Все причины и проверки

erpipe-org/mcp-odoo

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/odoo-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Собрано автоматически, проверьте перед установкой.

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio odoo-mcp -- uvx --setup

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "odoo-mcp": {
      "command": "uvx",
      "args": [
        "--setup"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

ODOO_MCP_ELICIT_WRITESнеобязательная
Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная
Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная
Rate limit mode: warn or block
ODOO_LOCALEнеобязательная
Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная
Enable direct chatter posting bypassing approval gate

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "odoo-mcp": {
      "command": "uvx",
      "args": [
        "--setup"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

ODOO_MCP_ELICIT_WRITESнеобязательная
Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная
Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная
Rate limit mode: warn or block
ODOO_LOCALEнеобязательная
Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная
Enable direct chatter posting bypassing approval gate

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"odoo-mcp","type":"stdio","command":"uvx","args":["--setup"]}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "odoo-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--setup"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

ODOO_MCP_ELICIT_WRITESнеобязательная
Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная
Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная
Rate limit mode: warn or block
ODOO_LOCALEнеобязательная
Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная
Enable direct chatter posting bypassing approval gate

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add odoo-mcp -- uvx --setup

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.odoo-mcp]
command = "uvx"
args = ["--setup"]

Если файл уже есть, допишите блок в конец.

Ключи и настройки

ODOO_MCP_ELICIT_WRITESнеобязательная
Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная
Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная
Rate limit mode: warn or block
ODOO_LOCALEнеобязательная
Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная
Enable direct chatter posting bypassing approval gate

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "odoo-mcp": {
      "command": "uvx",
      "args": [
        "--setup"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

ODOO_MCP_ELICIT_WRITESнеобязательная
Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная
Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная
Rate limit mode: warn or block
ODOO_LOCALEнеобязательная
Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная
Enable direct chatter posting bypassing approval gate

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "odoo-mcp": {
      "command": "uvx",
      "args": [
        "--setup"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

ODOO_MCP_ELICIT_WRITESнеобязательная
Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная
Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная
Rate limit mode: warn or block
ODOO_LOCALEнеобязательная
Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная
Enable direct chatter posting bypassing approval gate

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "odoo-mcp": {
      "command": "uvx",
      "args": [
        "--setup"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

ODOO_MCP_ELICIT_WRITESнеобязательная
Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная
Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная
Rate limit mode: warn or block
ODOO_LOCALEнеобязательная
Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная
Enable direct chatter posting bypassing approval gate

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "odoo-mcp": {
      "command": "uvx",
      "args": [
        "--setup"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

ODOO_MCP_ELICIT_WRITESнеобязательная
Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная
Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная
Rate limit mode: warn or block
ODOO_LOCALEнеобязательная
Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная
Enable direct chatter posting bypassing approval gate

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "odoo-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "--setup"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

ODOO_MCP_ELICIT_WRITESнеобязательная
Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная
Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная
Rate limit mode: warn or block
ODOO_LOCALEнеобязательная
Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная
Enable direct chatter posting bypassing approval gate

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "odoo-mcp": {
      "command": "uvx",
      "args": [
        "--setup"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

ODOO_MCP_ELICIT_WRITESнеобязательная
Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная
Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная
Rate limit mode: warn or block
ODOO_LOCALEнеобязательная
Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная
Enable direct chatter posting bypassing approval gate

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "odoo-mcp": {
      "command": "uvx",
      "args": [
        "--setup"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

ODOO_MCP_ELICIT_WRITESнеобязательная
Enable human-in-the-loop approval for writes
ODOO_MCP_AUDIT_LOGнеобязательная
Path to JSONL audit log file
ODOO_MCP_RATE_LIMIT_MODEнеобязательная
Rate limit mode: warn or block
ODOO_LOCALEнеобязательная
Locale for Odoo calls
MCP_CHATTER_DIRECTнеобязательная
Enable direct chatter posting bypassing approval gate

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 26 сент. 2026, коммит 76ec136.

Текст для агента

Поставь MCP-сервер: pip install odoo-mcp. Пропиши в конфигурации MCP запуск python -m odoo_mcp и переменные ODOO_URL, ODOO_DB, ODOO_USERNAME, ODOO_PASSWORD.

Другие способы из описания автора
pip install odoo-mcp

Устанавливает MCP-сервер из PyPI, запуск командой python -m odoo_mcp.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер подключает Odoo к агенту по протоколу MCP и дает инструменты для работы с моделями ERP: чтение записей, поиск, диагностика и запись с ограничениями. Записи проходят через защитный слой, поэтому агент не меняет данные бесконтрольно. Поддерживаются несколько экземпляров Odoo и редакции Community и Enterprise начиная с версии 16. Запускается локально по stdio, ставится из PyPI или через Docker, подключается к вашему серверу Odoo по XML-RPC или JSON-RPC. У того же автора есть отдельный размещенный продукт-шлюз, но этот репозиторий остается самостоятельным сервером для локального запуска.

Для кого. Для команд на Odoo, которым нужно, чтобы агент читал и аккуратно менял данные ERP.

Подходит, если

  • Нужно спрашивать у агента данные из Odoo: заказы, товары, контакты
  • Нужна защищенная запись изменений в Odoo через агента
  • Нужно подключить несколько экземпляров Odoo к одному агенту

Не подходит, если

  • У вас не Odoo, а другая ERP
  • Нельзя давать агенту доступ к производственной базе даже с ограничениями

Пример запроса к агенту

Покажи из Odoo неоплаченные счета за прошлый месяц по этому клиенту

Ограничения

Сервер подключается к вашему экземпляру Odoo и требует URL, базу, пользователя и пароль или API-ключ, поэтому доступ надо давать осознанно. Даже с защитой записи агент работает с данными ERP, что для боевой базы это высокий риск. Размещенный шлюз ERPipe это отдельный платный продукт вне этого репозитория. Работа зависит от совместимости версии Odoo и транспорта XML-RPC или JSON-RPC.

Как отключить. Уберите сервер odoo из конфигурации MCP клиента и удалите пакет: pip uninstall odoo-mcp или остановите контейнер Docker.

MCP

Транспорт
stdio
Авторизация
API-ключ
Переменные окружения
Переменные окружения
ODOO_URL
обязательная
Адрес вашего экземпляра Odoo
ODOO_DB
обязательная
Имя базы данных Odoo
ODOO_USERNAME
обязательная
Пользователь Odoo
ODOO_PASSWORD
обязательная, секрет
Пароль или API-ключ пользователя
ODOO_TRANSPORT
Транспорт подключения: xmlrpc или jsonrpc

Проверка безопасности

  • Подключается к базе Odoo по учетным данным
  • Может записывать изменения в данные ERP
  • Работает с производственными системами

Коротко о README

README представляет свободный слой ИИ для Odoo: сервер дает Community и Enterprise возможности, которые в самой Odoo доступны только в Enterprise. Установка занимает несколько минут, есть варианты pip install odoo-mcp, запуск через uvx и Docker, а также фрагмент конфигурации mcpServers с переменными подключения. Записи защищены, поддерживаются диагностика и несколько экземпляров. Репозиторий это локальный сервер на Python, а размещенный шлюз ERPipe вынесен в отдельный продукт. Лицензия MIT, пакет опубликован на PyPI.

Частые вопросы

Чем этот репозиторий отличается от ERPipe?

Здесь самостоятельный сервер для локального запуска по stdio с полным набором инструментов. ERPipe это отдельный размещенный шлюз того же автора с удаленным адресом.

Какие версии Odoo поддержаны?

Community и Enterprise начиная с версии 16, подключение по XML-RPC или JSON-RPC.

Официальный

Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента

MCP-серверВысокий риск483Звезды репозитория
Официальный

Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex

ПлагинВысокий рискРоссийский стекБез VPN28Звезды репозитория
Выбор редакции

Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию

MCP-серверВысокий рискРоссийский стекБез VPN
Официальный

Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма

MCP-серверВысокий рискРоссийский стекБез VPN
Foxx AIOdoo MCP

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.