MCP Odoo

tuanle96/mcp-odoo

Odoo MCP服务器是一个实现与Odoo ERP系统集成的中间件，通过Model Context Protocol协议让AI助手能够访问和操作Odoo数据和功能。

安装

docker run -i --rm -e ODOO_URL -e ODOO_DB -e ODOO_USERNAME -e ODOO_PASSWORD -e ODOO_TRANSPORT -e ODOO_API_KEY mcp/odoo:latest

客户端配置

{
  "mcpServers": {
    "odoo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ODOO_URL",
        "-e",
        "ODOO_DB",
        "-e",
        "ODOO_USERNAME",
        "-e",
        "ODOO_PASSWORD",
        "-e",
        "ODOO_TRANSPORT",
        "-e",
        "ODOO_API_KEY",
        "mcp/odoo:latest"
      ]
    }
  }
}

环境变量

ODOO_URLODOO_DBODOO_USERNAMEODOO_PASSWORDODOO_TRANSPORTODOO_API_KEYODOO_JSON2_DATABASE_HEADERODOO_MCP_ALLOWED_SIDE_EFFECT_METHODS

GitHub 星标: 95
作者: @tuanle96
分类: 电子商务与零售, 开发者工具
许可证: MIT
更新于: 2026年10月6日

工具（39）

list_models
List Odoo model technical names and labels.
get_model_fields
Read field metadata for one model.
search_records
Run bounded read-only search_read.
read_record
Read one record by model and ID.
aggregate_records
Server-side groupby/aggregation via formatted_read_group (Odoo 19+) or read_group (16-18).
search_employee
Search employees by name.
search_holidays
Search leave records by date range.
get_odoo_profile
Read server version, user context, transport, database, and installed module summary.
schema_catalog
Build a bounded model catalog with optional field metadata.
build_domain
Build and validate an Odoo domain from structured conditions.
read_attachment
Read an ir.attachment's metadata and size-capped base64 content (ODOO_MCP_MAX_ATTACHMENT_BYTES, default 1 MiB).
preview_write
Produce a non-executing approval payload for create, write, or unlink.
validate_write
Validate a write payload against trusted live fields_get metadata.
execute_approved_write
Execute only a same-session, live-validated, confirmed write when ODOO_MCP_ENABLE_WRITES=1.
execute_method
Execute a reviewed model method.
chatter_post
Post a chatter message on a mail.thread record.
diagnose_odoo_call
Diagnose a model call without executing it.
diagnose_access
Diagnose ACL and record-rule visibility for the current Odoo credential.
inspect_model_relationships
Group relationship fields, required fields, and create/write hints.
generate_json2_payload
Convert XML-RPC-shaped input into JSON-2 endpoint, headers, and named body.
upgrade_risk_report
Surface transport, method, and migration risks across Odoo versions.
lookup_model_history
Resolve outdated model names (account.invoice → account.move) against a curated per-version rename catalog.
scan_addons_source
Scan local addon source without importing addon code.
fit_gap_report
Classify requirements into standard, configuration, Studio, custom module, avoid, or unknown.
business_pack_report
Report expected modules, models, and discovery calls for sales, CRM, inventory, accounting, or HR.
index_knowledge
Fetch a bounded record slice once and build a local BM25 index (accent-insensitive; data never leaves the machine).
search_knowledge
Relevance-ranked free-text search over indexed records with zero further RPC calls.
knowledge_stats
Report per-model index sizes and the ODOO_MCP_KNOWLEDGE_MAX_DOCS budget.
receivable_payable_aging
Aged AR/AP report bucketed by days overdue (not due / 1-30 / 31-60 / 61-90 / 90+), with per-partner totals.
accounting_health_summary
Open receivable/payable item counts plus the draft invoice backlog.
submit_async_task
Run an allowlisted long read operation (scan_addons_source, index_knowledge, receivable_payable_aging) on a bounded worker pool.
get_async_task
Poll a task's status and result.
cancel_async_task
Cancel a pending or running task.
list_async_tasks
List live and recently finished tasks.
search_across_instances
Search every opted-in instance (or a list/tag selection); rows tagged with _instance, partial results on per-instance failure.
aggregate_across_instances
Group/aggregate per instance plus additive grand totals across the fleet.
accounting_health_across_instances
AR/AP aging across every client DB with combined buckets — the partner-network sweep.
health_check
Report non-secret MCP runtime posture, including rate-limit counters and field-ACL status when enabled.
list_instances
List configured Odoo instance names, URLs, databases, transports, and cross-instance tags — never credentials.