io.github.singleflo/odoo-assistant
Odoo Assistant MCP Server
Виртуальный сотрудник Odoo через Model Context Protocol (MCP). Этот сервер предоставляет LLM бизнес-логику, записи и рабочие процессы Odoo, позволяя безопасно запрашивать, создавать, обновлять и выполнять действия с данными Odoo.
Быстрый старт
1. Установка
Запустите сервер напрямую:
uvx odoo-assistantИли установите его в своё окружение:
uv pip install odoo-assistantУстановка из исходного кода для разработки также возможна:
uv pip install git+https://github.com/singleflo/odoo-assistant-mcp2. Настройка переменных окружения
Требуются две переменные; всё остальное определяется автоматически или имеет значение по умолчанию:
ODOO_BASE_URL: Базовый URL вашего экземпляра Odoo (например,https://mycompany.odoo.com).ODOO_API_KEY: API-ключ Odoo (Odoo 14+, создаётся в Настройки > Пользователи > API-ключи > Новый). Пароль от учётной записи не принимается: ключ привязан к пользователю, имеет ограниченную область действия и может быть отозван отдельно.
Дополнительная настройка:
ODOO_DB: Имя базы данных. Определяется автоматически, если экземпляр обслуживает только одну базу; обязательно, если их несколько — в сообщении об ошибке будут перечислены все.ODOO_USER: Логин. Определяется по ключу ценой до 59 дополнительных запросов; определение не удастся, если uid владельца ключа равен 60 или выше. Указание логина избавляет от проверки.ODOO_MCP_MAX_LEVEL: Максимальный уровень безопасности, который может выполнять этот сервер, от0до4(по умолчанию:3). С помощью этого параметра вы делаете сервер только для чтения или разрешаете удаление — см. Выбор предельного уровня.ODOO_MCP_PROTECTED_HOSTS: Разделённые запятыми хосты, на которые этот сервер отказывается записывать (по умолчанию пусто — ни один хост не встроен в пакет). Указанный хост всё равно разрешает чтение; для записи требуетсяODOO_ALLOW_PROD_WRITE=yesкак осознанное переопределение.
Related MCP server: mcp-server-odoo
Уровень безопасности
Каждая запись и действие проходят через динамический классификатор безопасности перед тем, как попасть в Odoo. Операции классифицируются по уровням от L0 до L5:
Уровень | Название | Описание | Статус по умолчанию |
L0 |
| Только чтение ( | Разрешено |
L1 |
| Запись и создание одной записи. | Разрешено |
L2 |
| Пакетная запись, затрагивающая несколько записей. | Разрешено |
L3 |
| Изменения состояния рабочего процесса (например, подтверждение заказов, проводка счетов). | Разрешено |
L4 |
| Деструктивные операции (например, | Заблокировано |
L5 |
| Частные методы или неизвестные операции. | Заблокировано |
Выбор предельного уровня
ODOO_MCP_MAX_LEVEL задаёт максимальный уровень, который может выполнять этот сервер. Каждое значение является накопительным — оно разрешает свой уровень и всё, что ниже:
Значение | Что разрешает |
| Только чтение. |
| + запись и создание одной записи. |
| + пакеты более 5 записей. |
| По умолчанию. + подтверждение заказов, проводка счетов, отправка почты. |
| + |
| Принимается, но по сути идентичен |
Стоит знать два поведения перед выбором числа:
5не открывает L5. Оба варианта L5 отклоняются до того, как уровень вообще считывается.L5_PRIVATEотклоняется, потому что Odoo сам отвергает любой метод, начинающийся с_, так что никакой предельный уровень не сможет его разрешить;L5_UNKNOWNотклоняется, потому что метод, не классифицированный никем, по определению имеет непроверенные последствия. Способ разрешить такой метод — добавить его вWRITE_L1/L3/L4вsafety_layer.py— в коде, с проверкой, а не через конфигурацию.Недопустимое значение приводит к ошибке при запуске.
ODOO_MCP_MAX_LEVEL="O"вызывает ошибку, а не откат к значению по умолчанию, потому что значение по умолчанию допускает запись: опечатка не должна дать вам сервер для записи, который вы считали только для чтения.
Предельный уровень задаётся вне канала связи, человеком, и считывается из окружения процесса при запуске. Модель, работающая с этим сервером, не может его повысить; когда вызов превышает предельный уровень, в отказе указывается требуемый уровень, чтобы агент мог объяснить, что изменит операция, и оставить решение за вами.
Обратите внимание, что это полномочия данного сервера, а не учётной записи. Агент с доступом к оболочке всегда может обойти MCP-сервер, вызвав Odoo напрямую. Ограничение, которое должно действовать независимо от клиента, относится к правам доступа Odoo пользователя, которому принадлежит API-ключ, — там его обеспечивает сервер Odoo.
Поддержка версий Odoo
Odoo 14.0 — абсолютный минимум поддерживаемой версии, так как этот сервер аутентифицируется только с помощью API-ключей, которых нет в Odoo 13 и более ранних.
Версия Odoo | API-ключи | XML-RPC | Официально поддерживается (авг. 2026) | Уровень поддержки / Примечания |
≤ 13.0 | Нет | Да | Нет | Не поддерживается. Невозможно аутентифицироваться с этим сервером. |
14.0 | Да | Да | Нет | Протокол совместим. Не тестировался на живом экземпляре. |
15.0 | Да | Да | Нет | Протокол совместим. Не тестировался на живом экземпляре. |
16.0 | Да | Да | Нет | Протокол совместим. Не тестировался на живом экземпляре. |
17.0 | Да | Да | Да (до сен. 2026) | Протокол совместим. Не тестировался на живом экземпляре. |
18.0 | Да | Да | Да (до сен. 2027) | Основная цель. Проверен и полностью поддерживается на живом экземпляре. |
19.0 | Да | Да | Да (до сен. 2028) | Протокол совместим. Не тестировался на живом экземпляре. API-ключи требуют описания и срока действия (макс. 3 месяца). |
Путь создания API-ключа
Чтобы создать API-ключ, войдите в свой экземпляр Odoo и перейдите по адресу: Настройки / Мой профиль → Безопасность учётной записи → Новый API-ключ
Примечание о транспорте и устаревании
Клиент автоматически определяет, доступен ли нативный API JSON-2 по адресу /json/2/<model>/<method> (использующий Authorization: bearer <API_KEY>), и в противном случае переключается на XML-RPC. Обратите внимание, что XML-RPC и JSON-RPC объявлены устаревшими в Odoo 19 и запланированы к удалению в Odoo 22.
Источники
Odoo 14.0 External API Documentation (введение в API-ключи)
Odoo 19.0 External API Documentation (JSON-2)
Odoo 19.0 External RPC API Documentation (устаревание XML-RPC)
Odoo Standard & Extended Support Policy (сроки поддержки)
Инструменты и ресурсы
Сервер предоставляет 19 инструментов и 2 типа ресурсов:
Инструменты
search_read: Поиск и чтение записей одним вызовом (Odoosearch_read).read_record: Чтение одной записи по id, всегда с указанными полями.count_records: Подсчёт записей, соответствующих домену (Odoosearch_count).instance_overview: Сводка подключённого экземпляра: версия, компании, объёмы по областям, внутренние модули, аномалии.required_fields: Список того, что Odoo требует передcreateдля модели, значение по умолчанию, которое он применил бы, и как существующие записи фактически его используют.create_record: Создание записи с повторным использованием существующего совпадения, если заданunique_on.write_record: Запись значений полей в одну запись и отчёт о том, что фактически изменилось.run_action: Запуск метода рабочего процесса и отчёт о состоянии, в котором он оставил запись.cancel_record: Отмена записи черезaction_cancelс последующим выполнением возвращаемого мастера.notify_user: Уведомление пользователей в чате записи. По умолчанию внутреннее.create_activity: Планирование действия: единственное уведомление, которое содержит срок.download_docs: Сохранение всех документов записи на диск, включая файлы из чата.generate_pdf: Генерация PDF записи и возврат места сохранения.list_message_targets: Список тех, кому можно отправить сообщение, и где — внутренние пользователи с присутствием (онлайн/отошёл/офлайн) и открытые беседы вызывающего. Спрашивайте это перед отправкой.read_conversation: Чтение беседы Discuss, сначала новые.send_direct_message: Отправка личного сообщения Discuss, которое появляется в системном трее чата пользователя в реальном времени — без электронной почты, достигает его независимо от настройки уведомлений.send_channel_message: Публикация в существующем канале Discuss; отказ, если в комнате есть не-сотрудник.explore_module: Изучение структуры модуля путём опроса живого экземпляра.list_known_modules: Список модулей, которые изучил этот сервер: имя, дата генерации, записи.
Инструменты 10-11 (notify_user, create_activity) уведомляют О записи и попадают в колокольчик Входящие; инструменты 14-17 — это беседы Discuss, которые попадают в системный трей чата. «Отправить сообщение пользователю X» — это второй тип: send_direct_message, а не notify_user.
Ресурсы
odoo://skill: Доступ к инструкциям навыка ассистента Odoo.odoo://ref/*: Доступ к сгенерированной справочной документации по изученным модулям.
Примеры конфигурации хостов
Каждый пример ниже содержит только то, что важно: две обязательные переменные и предельный уровень — единственный параметр, определяющий, может ли этот сервер писать, и указанный в файле, которым владеет человек. База данных и логин определяются автоматически, а 3 — значение по умолчанию для предельного уровня. Обратите внимание на кавычки: значения окружения — строки.
Claude Desktop
Добавьте это в ваш claude_desktop_config.json:
{
"mcpServers": {
"odoo-assistant": {
"command": "uvx",
"args": [
"odoo-assistant"
],
"env": {
"ODOO_BASE_URL": "https://mycompany.odoo.com",
"ODOO_API_KEY": "your-api-key-here",
"ODOO_MCP_MAX_LEVEL": "3"
}
}
}
}Cursor
Добавьте это в ваш .cursor/mcp.json или настройте в интерфейсе настроек Cursor:
{
"mcpServers": {
"odoo-assistant": {
"command": "uvx",
"args": [
"odoo-assistant"
],
"env": {
"ODOO_BASE_URL": "https://mycompany.odoo.com",
"ODOO_API_KEY": "your-api-key-here",
"ODOO_MCP_MAX_LEVEL": "3"
}
}
}
}VS Code Copilot
Добавьте это в ваш settings.json VS Code:
{
"mcp.servers": {
"odoo-assistant": {
"command": "uvx",
"args": [
"odoo-assistant"
],
"env": {
"ODOO_BASE_URL": "https://mycompany.odoo.com",
"ODOO_API_KEY": "your-api-key-here",
"ODOO_MCP_MAX_LEVEL": "3"
}
}
}
}opencode
Добавьте это в opencode.json или .opencode/opencode.json в вашем проекте, или в ~/.config/opencode/opencode.json, чтобы сделать сервер доступным везде:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"odoo-assistant": {
"type": "local",
"enabled": true,
"command": [
"uvx",
"odoo-assistant"
],
"timeout": 120000,
"environment": {
"ODOO_BASE_URL": "https://mycompany.odoo.com",
"ODOO_API_KEY": "your-api-key-here",
"ODOO_MCP_MAX_LEVEL": "3"
}
}
}
}Структура opencode отличается от указанных выше хостов в том, что он отвергает: ключ — mcp (не mcpServers), требуется type, command — это один массив, содержащий программу и её аргументы (отдельного args нет), а блок окружения — environment (не env).
Установите timeout осознанно. По умолчанию он равен 5000 мс, а первый вызов сессии включает аутентификацию плюс, для instance_overview, десятки XML-RPC запросов — что с комфортом превышает пять секунд на реальном экземпляре.
opencode считывает свою конфигурацию один раз при запуске и не перезагружает её «на лету», поэтому после редактирования закройте и перезапустите. Любые изменения, внесённые сюда — включая предельный уровень — вступят в силу только при следующем запуске.
ChatGPT (Пользовательские коннекторы)
Чтобы подключить этот сервер к ChatGPT через Пользовательские коннекторы:
Перейдите в Настройки → Коннекторы → Добавить коннектор.
Введите URL сервера или выберите из Реестра.
Введите учетные данные Odoo при появлении запроса.
Hermes
Добавьте сервер с помощью Hermes CLI:
hermes mcp add odoo-assistant \
--env ODOO_BASE_URL=https://mycompany.odoo.com \
--env ODOO_API_KEY=your-api-key-here \
--env ODOO_MCP_MAX_LEVEL=3 \
--args run odoo-assistantВ примерах опущены необязательные переменные. Установите ODOO_DB, если экземпляр обслуживает несколько баз данных, ODOO_USER, чтобы пропустить проверку uid, и ODOO_MCP_MAX_LEVEL, чтобы изменить максимальный уровень с его значения по умолчанию 3.
Лицензия
Этот проект лицензирован под лицензией MIT. Подробности см. в файле LICENSE.
Available Tools
19 toolscancel_recordCDestructiveInspect
Cancel a record through action_cancel, following the wizard it returns.
Destructive, so the default ceiling refuses it and says what would not.
Inputs: model (required), record_id (required). Returns: result
count_recordsAInspect
Count the records matching a domain (Odoo search_count).
A count is only as honest as its domain:
account.move/account.move.linewithout amove_typefilter is refused — it would count invoices, bills, credit notes and journal entries together and match no figure the user has ever seen.A count answers "how many", never "how much". For an amount, read
amount_total_signed(company currency) and neveramount_total.On a multi-company instance the count differs per company: pass
company_idsor you are reporting one company as the whole business.
Args: model: Odoo model, e.g. "crm.lead". domain: Odoo domain. Omit to count everything the model holds. company_ids: Companies to count in, e.g. [1, 2].
Inputs: model (required), domain, company_ids. Returns: result
create_activityAInspect
Schedule an activity: the only notification that carries a deadline.
A chatter note is passive. An activity appears in the assignee's To-Do list and turns overdue when the date passes.
Args: model: the Odoo model, e.g. "crm.lead". record_id: id of the record the activity hangs off. summary: the one-line title the assignee will read. user_id: res.users id of the assignee. days: deadline offset from today, in days. activity_type: substring of an activity type name, e.g. "call". Activity types differ per instance; the first available type is used when this is omitted or matches nothing.
Inputs: model (required), summary (required), user_id (required), record_id (required), +2 more. Returns: result
create_recordAInspect
Create a record, reusing an existing match when unique_on is given.
unique_on is a list of FIELD NAMES taken from values (e.g.
["name", "email"]): they are searched first and the existing id comes
back instead of a duplicate. Odoo has no idempotency key, so a create that
is retried is simply a second record — this is the only protection there
is, and a cold-start run without it produced four identical customers.
Multi-company: put company_id in values. The context decides what is
visible, not which company owns the new record.
Inputs: model (required), values (required), unique_on. Returns: result
download_docsAInspect
Save every document of a record to disk — chatter files included.
Returns {"saved": [paths], "skipped": [[name, why]]}. skipped is not
noise: a database restored without its filestore keeps the attachment
rows and loses the bytes, and an empty result would read exactly like
"this record has no attachments".
Args: model: the Odoo model, e.g. "account.move". record_id: id of the record whose documents to fetch. dest_dir: directory to write the files into. Defaults to this platform's temporary directory — "/tmp" does not exist on Windows.
Inputs: model (required), record_id (required), dest_dir. Returns: result
explore_moduleBInspect
Discover a module's structure by interrogating the live instance.
Args:
module_name: Module to explore, e.g. "helpdesk". Must be a module
slug, since it names the reference file on "generate"; ignored
on "list".
action: "generate" (the default) writes the reference document,
"list" ranks what is worth exploring.
models: Comma-separated models for a module the script does not know,
e.g. "superchat.message,superchat.template". Defaults to the
script's own grouping for module_name.
Inputs: module_name (required), action, models. Returns: result
generate_pdfAInspect
Render the PDF of a record and return where it was saved.
An already rendered PDF is reused. Otherwise the model's own print/send
wizard produces it, and that wizard can also SEND the document — which is
why this is gated on action_send_and_print (L3_STATE_CHANGE) rather
than as a plain read.
Args: model: the Odoo model, e.g. "account.move". record_id: id of the record to print. dest_dir: directory to write the PDF into. Defaults to this platform's temporary directory — "/tmp" does not exist on Windows.
Inputs: model (required), record_id (required), dest_dir. Returns: result
instance_overviewAInspect
Summarise the connected instance: version, companies, volumes per area, in-house modules, anomalies.
The profile is built from the instance this server is CONNECTED to, and
cached per instance — census.profile_path() keys it on the live client,
not on an environment variable. That distinction is the whole point: with
two instances profiled on one machine, choosing by ODOO_DB (which is
discovered now, so often unset) once fell through to "the first file on
disk" and reported a neighbour's numbers as this instance's, with no error
and a perfectly plausible report.
First call against a new instance builds the profile, which costs a second
or so; every later call is free. Pass refresh=True after the instance has
changed — the report carries the timestamp it was taken.
When drilling into these figures, the two rules that keep them meaningful:
filter account.move by move_type, and sum amount_total_signed, never
amount_total.
Args: refresh: rebuild the profile from the instance instead of reusing it.
Inputs: refresh. Returns: result
list_known_modulesAInspect
List the modules this server has learned: name, generation date, records.
Inputs: no named parameters. Returns: result
list_message_targetsAInspect
Who can be messaged and where — ASK THIS BEFORE SENDING ANYTHING.
Two lists in one call, because an agent that cannot see the roster invents ids:
users: the internal, active users, each withim_status— 'online', 'away' (idle 30 minutes) or 'offline'. Presence is worth reading first: a Discuss message is delivered either way, but "offline" tells you nobody is going to answer right now.conversations: the ones the sender already belongs to and has not archived, withchannel_type— 'chat' is a 1-to-1, 'group' is a private multi-party, 'channel' is a room that may hold the whole company.membersandunreadare there so a broadcast is a deliberate choice rather than a surprise.
Use send_direct_message for a person and send_channel_message for a
conversation in this list. Neither of them is the tool for annotating an
invoice or an order — that is notify_user.
Inputs: no named parameters. Returns: result
notify_userAInspect
Write a note on a record's chatter and notify the users you name.
Both subtypes post a message that IS VISIBLE in the record's chatter. The difference is who it reaches beyond the people you name.
Args:
model: the Odoo model, e.g. "sale.order".
record_id: id of the record to write on.
message: the body. Send PLAIN TEXT: Odoo escapes anything that arrives
over RPC, so "x" is displayed as the literal characters
<b>x</b>, not as bold — there is no way to pass real markup
through this call, and newlines survive but are not turned into
line breaks. Write the note as prose.
user_ids: res.users ids to notify. They are notified each through
their OWN Odoo setting, inbox or email, so naming someone is not a
promise that no mail leaves.
subtype: where the message lands.
| subtype | visible in the chatter | emails a customer |
|-----------|------------------------|-------------------|
| "note" | yes, internal users | never |
| "inbox" | NO — notification only | never |
| "comment" | yes, everyone | **YES** |
"note" posts `mail.mt_note` and is the default: measured on a real
order it produced one inbox notification and zero emails.
"inbox" goes through `message_notify`, which Odoo documents as the
path for "messages that should not be displayed on a document" —
the person is notified, the record keeps no trace. "comment" posts
`mail.mt_comment` and is refused while an external follower
exists, unless force=True.
force: post the comment anyway, knowing those people get an email.
Inputs: model (required), message (required), user_ids (required), record_id (required), +2 more. Returns: result
read_conversationAInspect
Read what was said in a Discuss conversation, newest first.
This is how you answer "what did they write to me" or "what is going on in
that channel". list_message_targets gives you the channel_id and says
how many messages are unread.
Reading does not mark anything as read: the unread counter belongs to the member record and only the user's own client clears it.
Args:
channel_id: the Discuss channel, from list_message_targets.
limit: how many recent messages to return.
Inputs: channel_id (required), limit. Returns: result
read_recordAInspect
Read one record by id, always with named fields (writing.md pattern 12).
Omitting fields asks for a short list of state fields — never for all of
them: that read is slow at best and fails at worst.
account.move and account.move.line are refused here, because the
structural guard wants a move_type filter and this tool has nowhere to
put one. Use search_read with
[["id", "=", <id>], ["move_type", "=", "out_invoice"]] instead.
And never add up amount_total across records — it is in the record's own
currency. amount_total_signed is the company-currency twin to sum.
Args: model: Odoo model, e.g. "sale.order". record_id: The record's database id. fields: Field names to read. Omit for the usual state fields.
Inputs: model (required), record_id (required), fields. Returns: result
required_fieldsAInspect
List the fields Odoo demands before it will accept a create, with the
default it would apply and how existing records actually use it.
Ask this BEFORE create_record on a model you have not written to in this
session. The answer is read from the live instance — fields_get plus
default_get — never from a table in this file, so a model customised
in-house reports its own requirements.
The dangerous required field is the one that already carries a default: the
create succeeds without you naming it and the record lands wherever the
default points, with no error to notice. crm.lead.type is the standing
example — Odoo defaults it to 'lead', and on an instance that works its
pipeline as opportunities that record goes straight to a menu nobody opens.
That is why the live distribution is printed beside each default.
Args: model: Odoo model, e.g. "crm.lead".
Inputs: model (required). Returns: result
run_actionADestructiveInspect
Run a workflow method and report the state it left behind.
The level follows method: confirming or posting is a state change,
cancelling or unlinking is destructive and refused unless the server's
ceiling was raised deliberately.
Two behaviours come from the Writer and are worth knowing: a returned dict
carrying res_model is a wizard to follow rather than a result, and a
transition is one-way — calling it twice raises instead of doing nothing.
Inputs: model (required), method (required), record_ids (required). Returns: result
search_readAInspect
Search and read records in one call (Odoo search_read).
Two pitfalls this tool cannot fix for you:
account.moveandaccount.move.linemix customer invoices, vendor bills, credit notes and raw journal entries. A domain withoutmove_typeis refused — add["move_type", "=", "out_invoice"](orin_invoice,out_refund,in_refund) so the answer matches what the user sees on screen.NEVER sum
amount_total: it is expressed in each record's own currency, and eight foreign-currency invoices once inflated a total 11,9×. Ask foramount_total_signedinstead — any field with a_signedtwin is stored in company currency, and the twin is the one to add up.
Args: model: Odoo model, e.g. "sale.order". domain: Odoo domain, e.g. [["state", "=", "sale"]]. fields: Field names to return. Name them: the default asks for every field, which is slow and can fail to serialise on wide models. limit: Rows to return. Hard-capped at 200. offset: Rows to skip — how to page past a truncated result. company_ids: Companies to read from, e.g. [1, 2]. On a multi-company instance, omitting this reports one company as the whole business.
Inputs: model (required), domain (required), limit, fields, +2 more. Returns: result
send_channel_messageAInspect
Post to an EXISTING Discuss channel — everyone in it sees this.
The channel is never created here: list_message_targets shows the ones
that exist, and posting to a room of the wrong size is not recoverable by
deleting the message afterwards.
Members who are not employees of this instance — portal users, guests —
are named in a refusal rather than written to, the same rule notify_user
applies to external followers. Nothing is posted in that case.
Args:
channel_id: from list_message_targets.
message: the body, plain text or simple HTML.
Inputs: message (required), channel_id (required). Returns: result
send_direct_messageAInspect
Send a 1-to-1 Discuss message that appears in the user's chat systray.
This is the tool for "tell X", "message X", "warn X". It opens the private
chat with that user — reusing the existing one, channel_get matches on
the exact pair — and posts there. The bus pushes it in real time and it
persists, so a recipient who is offline finds it on their next login.
It reaches them whatever their notification setting says, and sends no
email at all. That is the difference from notify_user, which follows the
recipient's preference and lands in the Inbox bell instead.
Args:
user_id: res.users id of the recipient — from list_message_targets.
message: the body, plain text or simple HTML.
Inputs: message (required), user_id (required). Returns: result
write_recordADestructiveIdempotentInspect
Write field values to one record and report what actually changed.
Writing the value a record already holds succeeds and changes nothing; only the before/after comparison tells that apart from a real update, so that comparison is the answer.
Setting active to False archives the record — the same visible outcome as
deleting it — and is classified destructive rather than as a plain write.
Inputs: model (required), values (required), record_id (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Each tool targets a distinct Odoo operation: reading, searching, counting, creating, writing, workflow actions, messaging, module exploration, etc. While messaging has multiple tools (notify_user, send_direct_message, send_channel_message), their descriptions clearly differentiate by context (record chatter, 1-to-1 chat, channel). No overlapping purposes remain ambiguous.
All tools follow a consistent verb_noun pattern in snake_case (e.g., search_read, create_record, list_message_targets). The naming is predictable and intuitive, with verbs like read, create, write, send, list, and explore clearly indicating the action.
With 19 tools, the server covers a broad set of Odoo capabilities (CRUD, workflow, messaging, file handling, module introspection). While slightly above the typical 3-15 recommended range, the count is justified by the complexity of the ERP domain and each tool serves a distinct purpose without redundancy.
The tool surface covers essential CRUD operations, workflow actions, messaging, document handling, and instance/ module exploration. However, there is no dedicated delete tool (only cancel for specific workflows) and no bulk update or file upload tool. These minor gaps are workable but prevent full lifecycle coverage.
Maintenance
Related MCP Connectors
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Odoo MCP connector for ChatGPT and Claude: ask sales, invoices and stock in plain words. Read-only.
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Related MCP Servers
- AlicenseBqualityNot gradedmaintenanceAn MCP server that enables AI assistants to interact with Odoo ERP apps like Inventory, CRM, Sales, and Manufacturing. It allows users to read, create, and manage Odoo records and workflows using natural language commands.251MIT
- AlicenseNot gradedqualityDmaintenanceAn extensible MCP server that integrates Odoo with LLMs to enable querying and managing business data like partners, quotations, and sales orders. It supports custom tool registration and multiple transport protocols for both local and remote communication.2MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that connects AI assistants to Odoo ERP instances via the built-in XML-RPC API without requiring any additional addons. It enables users to search, create, update, and manage Odoo records and models through natural language.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants to interact with Odoo ERP, allowing natural language queries, record creation, updates, and deletions.LGPL 3.0