Odoo MCP server

Read from the package source without running it. The installed server may list more.

• accounting_health_across_instances

  AR/AP aging fanned out across instances — the partner-network sweep

• accounting_health_summary

  Open receivable/payable item counts and draft invoice backlog

• aggregate_across_instances

  Read-only aggregate fanned out across instances with combined grand totals

• aggregate_records

  Group records server-side and aggregate measures.

• analyze_upgrade_log

  Parse an Odoo install/update/upgrade log and classify known failure patterns (xpath breaks, missing fields/models/external ids, NOT NULL violations, dependency errors, attrs removal, ORM signature changes) into an actionable worklist. Input-driven — never contacts Odoo. Paste the relevant log slice (up to ~1 MB); findings are deduplicated.

• build_domain

  Build a validated Odoo domain from structured conditions

• business_pack_report

  Report expected modules, models, and safe discovery calls for a business pack

• cancel_async_taskwrite action

  Cancel a pending or running background task

• chatter_postwrite action

  Post a message on the chatter of a mail.thread-derived record.

• data_quality_report

  Evidence-first data-quality report for a model (never modifies data).

• diagnose_access

  Diagnose ACL and record-rule visibility for an Odoo model

• diagnose_odoo_call

  Diagnose an Odoo model call without executing it

• execute_approved_writewrite action

  Execute a previously previewed and confirmed standard write

• execute_methodwrite action

  Execute a custom method on an Odoo model

• fit_gap_report

  Classify Odoo requirements into fit/gap implementation buckets

• generate_json2_payload

  Build a JSON-2 request preview without network access

• get_async_task

  Poll a background task's status and result

• get_model_fields

  Get field metadata for a specific Odoo model

• get_odoo_profile

  Read a bounded profile of the connected Odoo environment

• health_check

  Report this MCP server's non-secret runtime safety posture

• index_knowledge

  Fetch a bounded slice of records and build a local BM25 knowledge index

• inspect_model_relationships

  Inspect model relationships and required field metadata

• knowledge_stats

  Report local knowledge index sizes and document budget

• list_async_tasks

  List recent background tasks newest-first

• list_instances

  List configured Odoo instance names without credentials

• list_models

  List Odoo models with optional name filtering

• lookup_model_history

  Resolve a possibly outdated model name against a curated rename catalog.

• preview_writewrite action

  Preview create, write, or unlink without executing it

• read_attachment

  Read one ir.attachment record: metadata always, base64 content when it fits under the cap (ODOO_MCP_MAX_ATTACHMENT_BYTES, default 1 MiB). URL-type attachments return their URL instead of content.

• read_record

  Read a single Odoo record by model and ID

• receivable_payable_aging

  Aged receivable/payable report bucketed by days overdue

• scan_addons_source

  Scan local Odoo addon source without importing addon code

• schema_catalog

  Build and cache a bounded Odoo model schema catalog

• search_across_instances

  Read-only search fanned out across configured Odoo instances, merged and attributed

• search_employee

  Search for employees by name

• search_holidays

  Search for holidays within a date range

• search_knowledge

  Relevance-ranked local BM25 search over previously indexed records

• search_records

  Search and read records with bounded read-only semantics.

• submit_async_taskwrite action

  Run an allowlisted long-running read operation in the background

• upgrade_risk_report

  Report Odoo upgrade and JSON-2 migration risks

• validate_writewrite action

  Validate a standard write payload against optional fields_get metadata

• Code scan37 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 31 days ago12/15
• Maintainer identityregistry namespace matches repository owner7/10

Safety score

77/100

higher than 50% of 48,255 servers

Tools

41

the typical server has 7

Tools that change things

17%

typical: 0%. Fewer write tools means less an agent can break

GitHub stars

415

more than 95% of 28,688 servers

Odoo: common questions

Is Odoo MCP server safe?

Mostly: it is graded B (77/100). Read the Odoo safety report

How do I install Odoo?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Odoo need an API key?

Yes. The registry entry asks for ODOO_PASSWORD.

Is Odoo maintained?

The last commit was 71 days ago (2026-08-25). The latest release is v1.3.0.

How does Odoo compare with other MCP servers?

safety score 77/100 (higher than 50% of 48,255 servers); tools 41 (the typical server has 7); tools that change things 17% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.