Odoo Mcp Connector

io.github.management-cmyk由 GitHub 帳號 management-cmyk 發布v0.1.0更新於 Oct 24, 2026

Query, report on, and optionally modify any Odoo ERP from Claude. Read-only by default.

已驗證STDIO僅桌面資料庫資料與分析商業與電商

概覽

AI 產生的概覽

將 Claude 連接到您自己的 Odoo ERP，用來搜尋、讀取、產生報表，並可選擇性地建立、更新或刪除業務記錄。

可以做什麼
這是一個本機 MCP 伺服器，透過 API 與您的 Odoo 實例通訊。它提供通用模型存取（搜尋並讀取記錄、依 ID 讀取、計數、檢視欄位、列出模型），以及現成的業務工具，例如逾期發票、銷售摘要、低庫存產品與主要客戶。明確啟用寫入後，還能建立、更新、刪除記錄並呼叫任意模型方法。
適用情境
當您想用自然語言查詢 Odoo 資料（發票、銷售、庫存、客戶），或讀取任意 Odoo 模型中的記錄時使用。適合先以唯讀方式產生報表，只有在明確選擇後才啟用寫入。
執行需求
透過 npx（Node.js）在本機執行。需要 ODOO_URL、ODOO_DB、ODOO_USERNAME 與 ODOO_API_KEY（Odoo API 金鑰或密碼）；可選 ODOO_ENABLE_WRITES 與 ODOO_TIMEOUT_MS。需要能連線到您的 Odoo 實例，且僅支援桌面端。
安裝前請注意
ODOO_API_KEY 是存取您 ERP 的憑證，請勿放入共用設定，外洩時應立即撤銷。寫入預設為關閉——設定 ODOO_ENABLE_WRITES=true 後，模型可建立、更新與刪除真實業務記錄，且 odoo_unlink 的刪除無法復原。操作受您 Odoo 使用者自身權限限制。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Odoo Mcp Connector，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Odoo MCP Server

[tests]

A Model Context Protocol server for Odoo. Connect Claude (or any MCP client) to your own Odoo ERP and query, report on, and optionally modify your data in natural language.

Works with any Odoo model. Safe by default: read only unless you explicitly enable writes. Your credentials stay on your machine. Nothing is stored or sent anywhere except your own Odoo instance.

Features

  • Generic access to any model: search, read, count, introspect fields, list models
  • Ready made business tools: overdue invoices, sales summary, low stock products, top customers
  • Read only by default: create, update and delete only when you opt in (ODOO_ENABLE_WRITES=true)
  • Your data, your machine: configured entirely through environment variables

Install

Add this to your MCP client config (e.g. Claude Desktop or Claude Code):

json
{  "mcpServers": {    "odoo": {      "command": "npx",      "args": ["-y", "odoo-mcp-connector"],      "env": {        "ODOO_URL": "https://your-company.odoo.com",        "ODOO_DB": "your-database",        "ODOO_USERNAME": "[email protected]",        "ODOO_API_KEY": "your-odoo-api-key"      }    }  }}

Getting an Odoo API key

In Odoo: Settings, Users, your user, Account Security, New API Key. Paste the generated key into ODOO_API_KEY. (A password also works, but an API key is safer and revocable.)

Enabling writes

Read only is the default. To let the model create, update, or delete records, add:

json
"ODOO_ENABLE_WRITES": "true"

Odoo holds real business data. Enable writes only when you accept that the model can create, modify or delete records, always within your Odoo user's own permissions.

Tools

Always available (read only)

ToolPurpose
odoo_search_readSearch + read records from any model
odoo_readRead records by ID
odoo_countCount records matching a domain
odoo_fieldsIntrospect a model's fields (name, type, label)
odoo_list_modelsList available models
odoo_overdue_invoicesUnpaid customer invoices past their due date
odoo_sales_summaryRevenue + order count over a date range
odoo_low_stockProducts at/below a quantity threshold
odoo_top_customersTop customers by invoiced revenue

Only when ODOO_ENABLE_WRITES=true

ToolPurpose
odoo_createCreate a record
odoo_writeUpdate records by ID
odoo_unlinkDelete records by ID (irreversible)
odoo_callCall an arbitrary model method

Configuration reference

VariableRequiredDefaultDescription
ODOO_URLyesYour Odoo base URL
ODOO_DByesDatabase name
ODOO_USERNAMEyesLogin (email)
ODOO_API_KEYyesAPI key (or password)
ODOO_ENABLE_WRITESnofalseSet "true" to allow writes
ODOO_TIMEOUT_MSno30000Per-request timeout (ms)

Development

bash
npm installnpm test       # vitest, fully mocked, no live Odoo needednpm run build

License

MIT, Falak Sarhan Saade

來源：README.md，提交 6e415e3

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分