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 分