Skip to main content
Glama
io.github.singleflo/odoo-assistant

io.github.singleflo/odoo-assistant

by singleflo

Odoo Assistant MCP Server

Model Context Protocol(MCP)を介したOdoo仮想従業員です。このサーバーはOdooのビジネスロジック、レコード、ワークフローをLLMに公開し、Odooデータの安全なクエリ、作成、更新、操作を可能にします。

クイックスタート

1. インストール

サーバーを直接実行します:

uvx odoo-assistant

または、環境にインストールします:

uv pip install odoo-assistant

開発用にソースからインストールすることも可能です:

uv pip install git+https://github.com/singleflo/odoo-assistant-mcp

2. 環境変数の設定

2つの変数が必要です。その他は自動検出されるか、デフォルト値があります。

  • ODOO_BASE_URL:OdooインスタンスのベースURL(例:https://mycompany.odoo.com)。

  • ODOO_API_KEY:Odoo APIキー(Odoo 14+、設定 > ユーザー > APIキー > 新規作成で生成)。アカウントパスワードは受け付けられません。キーはユーザーごと、スコープ付きで、単独で取り消し可能です。

オプション設定:

  • ODOO_DB:データベース名。インスタンスが1つのデータベースのみを提供する場合は自動検出されます。複数のデータベースを提供する場合は必須で、エラー時にすべてのデータベース名が表示されます。

  • 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

L0_READ

読み取り専用クエリ(search_read、read、search_count)。

許可

L1

L1_WRITE

単一レコードの書き込みと作成。

許可

L2

L2_BATCH

複数レコードに影響するバッチ書き込み。

許可

L3

L3_STATE_CHANGE

ワークフローの状態遷移(例:注文の確認、請求書の転記)。

許可

L4

L4_DESTRUCTIVE

破壊的操作(例:unlink、action_cancel、アーカイブ)。

ブロック

L5

L5_PRIVATE / L5_UNKNOWN

プライベートメソッドまたは不明な操作。

ブロック

天井の選択

ODOO_MCP_MAX_LEVELは、このサーバーが実行できる最高レベルを設定します。各値は累積的で、自身のレベルとそれ以下のすべてを許可します:

値

許可される内容

0

読み取りのみ。

1

+ 単一レコードの書き込みと作成。

2

+ 5レコードを超えるバッチ。

3

デフォルト。 + 注文の確認、請求書の転記、メール送信。

4

+ unlink、action_cancel、アーカイブ。

5

受け入れられますが、効果は4と同じです。以下を参照。

数値を選ぶ前に知っておくべき2つの動作があります:

  • 5はL5をアンロックしません。 両方のL5バリアントは、天井が読み取られる前に拒否されます。L5_PRIVATEは、Odoo自体が_で始まるすべてのメソッドを拒否するため、どの天井でも提供できません。L5_UNKNOWNは、誰も分類していないメソッドは定義上、未レビューの影響を持つため拒否されます。そのようなメソッドを許可する方法は、safety_layer.pyのWRITE_L1/L3/L4に追加することです。コード内でレビューされ、設定によってではありません。

  • 無効な値は起動を拒否します。 ODOO_MCP_MAX_LEVEL="O"はデフォルトにフォールバックするのではなくエラーを発生させます。なぜなら、デフォルトは書き込み可能だからです。タイプミスによって、読み取り専用だと思っていたサーバーが書き込み可能になることを防ぎます。

天井は人間によって帯域外で設定され、起動時にプロセス環境から読み取られます。このサーバーに対して実行されるモデルは天井を上げることはできません。呼び出しが天井を超えた場合、拒否メッセージには必要なレベルが示されるため、エージェントは操作が何を変更するかを説明し、決定をあなたに委ねることができます。

これはこのサーバーの権限であり、アカウントの権限ではないことに注意してください。シェルアクセスを持つエージェントは、Odooを直接呼び出すことでMCPサーバーを常にバイパスできます。クライアントに関係なく保持しなければならない制限は、APIキーが属するユーザーのOdooアクセス権限に設定する必要があります。そこではOdooサーバーがそれを強制します。

Odooバージョンサポート

Odoo 14.0はサポートされる絶対最小バージョンです。このサーバーはAPIキーのみを使用して認証するため、Odoo 13以前には存在しません。

Odooバージョン

APIキー

XML-RPC

公式メンテナンス(2026年8月)

サポートレベル/備考

≤ 13.0

いいえ

はい

いいえ

未サポート。このサーバーで認証できません。

14.0

はい

はい

いいえ

プロトコル互換。実インスタンスでのテスト未実施。

15.0

はい

はい

いいえ

プロトコル互換。実インスタンスでのテスト未実施。

16.0

はい

はい

いいえ

プロトコル互換。実インスタンスでのテスト未実施。

17.0

はい

はい

はい(2026年9月まで)

プロトコル互換。実インスタンスでのテスト未実施。

18.0

はい

はい

はい(2027年9月まで)

プライマリターゲット。実インスタンスで検証済み、完全サポート。

19.0

はい

はい

はい(2028年9月まで)

プロトコル互換。実インスタンスでのテスト未実施。APIキーには説明と有効期限(最大3ヶ月)が必要です。

APIキー生成パス

APIキーを生成するには、Odooインスタンスにログインし、次の場所に移動します: 設定 / マイプロフィール → アカウントセキュリティ → 新しいAPIキー

トランスポートと非推奨に関する注意

クライアントは、ネイティブJSON-2 APIが/json/2/<model>/<method>で利用可能かどうかを自動的に検出し(Authorization: bearer <API_KEY>を使用)、利用できない場合はXML-RPCにフォールバックします。XML-RPCとJSON-RPCはOdoo 19で非推奨となり、Odoo 22で削除される予定です。

ソース

ツールとリソース

サーバーは19のツールと2つのリソースタイプを公開します:

ツール

  1. search_read:1回の呼び出しでレコードを検索して読み取ります(Odoo search_read)。

  2. read_record:IDで1つのレコードを読み取り、常に名前付きフィールドを使用します。

  3. count_records:ドメインに一致するレコードをカウントします(Odoo search_count)。

  4. instance_overview:接続されたインスタンスの概要(バージョン、会社、エリアごとのボリューム、社内モジュール、異常)を要約します。

  5. required_fields:モデルに対するcreateの前にOdooが要求するもの、適用されるデフォルト値、および既存のレコードが実際にどのように使用しているかをリストします。

  6. create_record:レコードを作成し、unique_onが指定されている場合は既存の一致を再利用します。

  7. write_record:1つのレコードにフィールド値を書き込み、実際に変更された内容を報告します。

  8. run_action:ワークフローメソッドを実行し、その後に残された状態を報告します。

  9. cancel_record:action_cancelを使用してレコードをキャンセルし、返されたウィザードに従います。

  10. notify_user:レコードのチャッターでユーザーに通知します。デフォルトは内部通知です。

  11. create_activity:アクティビティをスケジュールします。期限を伴う唯一の通知です。

  12. download_docs:レコードのすべてのドキュメントをディスクに保存します(チャッターファイルを含む)。

  13. generate_pdf:レコードのPDFをレンダリングし、保存場所を返します。

  14. list_message_targets:メッセージを送信できる相手とその場所(プレゼンス(オンライン/離席/オフライン)を持つ内部ユーザー、および呼び出し元の開いている会話)をリストします。送信前にこれを問い合わせてください。

  15. read_conversation:Discussの会話を新しい順に読み取ります。

  16. send_direct_message:1対1のDiscussメッセージを送信し、ユーザーのチャットシステムトレイにリアルタイムで表示されます。メールは送信されず、通知設定に関係なくユーザーに届きます。

  17. send_channel_message:既存のDiscussチャンネルに投稿します。非従業員がいるルームは拒否します。

  18. explore_module:ライブインスタンスに問い合わせてモジュールの構造を発見します。

  19. list_known_modules:このサーバーが学習したモジュール(名前、生成日、レコード)をリストします。

ツール10-11(notify_user、create_activity)はレコードに関する通知を行い、受信箱のベルに届きます。ツール14-17はDiscussの会話で、チャットシステムトレイに届きます。「ユーザーXにメッセージ」は2番目の種類で、notify_userではなくsend_direct_messageです。

リソース

  • odoo://skill:Odooアシスタントスキルの指示にアクセスします。

  • odoo://ref/*:探索されたモジュールの生成されたリファレンスドキュメントにアクセスします。

ホスト設定例

以下の各例には、重要なものだけが含まれています。2つの必須変数と天井です。天井は、このサーバーが書き込み可能かどうかを決定する唯一の設定で、人間が所有するファイルに表示されます。データベースとログインは自動検出され、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設定UIで設定します:

{
  "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

VS Codeのsettings.jsonに追加します:

{
  "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 msで、セッションの最初の呼び出しは認証に加え、instance_overviewの場合は数十回のXML-RPCラウンドトリップが発生します。実インスタンスに対しては5秒を優に超えます。

opencodeは設定を起動時に一度だけ読み取り、ホットリロードしないため、編集後は終了して再起動してください。ここで変更した内容(天井を含む)は、次回起動時にのみ有効になります。

ChatGPT(カスタムコネクタ)

このサーバーをカスタムコネクタ経由でChatGPTに接続するには:

  1. 設定 → コネクタ → コネクタを追加 に移動します。

  2. サーバーURLを入力するか、レジストリから選択します。

  3. プロンプトが表示されたら、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 を、uidプローブをスキップする場合は ODOO_USER を、デフォルトの 3 から上限を変更する場合は ODOO_MCP_MAX_LEVEL を設定してください。

ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については LICENSE ファイルを参照してください。

Available Tools

19 tools
cancel_recordC
Destructive
Inspect

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.line without a move_type filter 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 never amount_total.

  • On a multi-company instance the count differs per company: pass company_ids or 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 with im_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, with channel_type — 'chat' is a 1-to-1, 'group' is a private multi-party, 'channel' is a room that may hold the whole company. members and unread are 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_actionA
Destructive
Inspect

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.move and account.move.line mix customer invoices, vendor bills, credit notes and raw journal entries. A domain without move_type is refused — add ["move_type", "=", "out_invoice"] (or in_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 for amount_total_signed instead — any field with a _signed twin 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_recordA
DestructiveIdempotent
Inspect

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

    A3.7/5.0

    Scored across 19 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityActive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      Not graded
      maintenance
      An 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.
      25
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables AI assistants to interact with Odoo ERP, allowing natural language queries, record creation, updates, and deletions.
      LGPL 3.0