Odoo Surface MCP

Give your AI agent full, user-equivalent access to any Odoo instance — create, read, update, and manage records, website pages, and snippets, all through natural conversation.

View on GitHub npm Package

The Bridge Between AI and Odoo

Think of Odoo Surface MCP as the control tower that lets an AI pilot navigate your entire Odoo instance — not just read dashboards, but actually land planes.

Most AI integrations with ERP systems are read-only. Odoo Surface MCP implements the Model Context Protocol (MCP) — an open standard developed by Anthropic — so AI agents like Claude can perform any operation a human user can: creating sales orders, updating contacts, building website pages, and more.

The Surface in the name reflects the design goal: expose the full surface area of Odoo to AI, not just a narrow API slice.

AI agent controlling Odoo

What It Can Do

Full CRUD, website building, and debugging — all through natural language.

📁

Full CRUD on Any Model

Create, read, update, and archive records on any Odoo model. Search with domains, paginate lists, read form fields, manage many2many relations — exactly as a human user would.

🌐

Website Page Builder

List and inject Odoo snippets, write page content, manage website pages, and control publish state — all without opening the browser editor. This very page was built using the MCP.

🔍

Debug & Inspect

Ping the server, inspect model views and actions, dump field metadata, clear cache, and restart the MCP process — giving AI agents full observability into the Odoo instance.

Installation steps

Installation in less than 60 Seconds

Distributed as an npm package and runs via npx — no installation required. Node.js is the only prerequisite, and it ships pre-installed with most developer environments.

npm version
1. Add to your MCP client config
{
  "mcpServers": {
    "odoo-surface": {
      "command": "npx",
      "args": ["-y", "@suco/odoo-surface-mcp@latest"],
      "env": {
        "ODOO_URL": "http://localhost:8069",
        "ODOO_DB": "your_database",
        "ODOO_USER": "admin",
        "ODOO_PASSWORD": "admin"
      }
    }
  }
}
2. Restart your AI client — done.

Full Documentation →

Ready to Give Your AI Agent Odoo Access?

Open source, MIT licensed, production-tested on Odoo 17. Works with Claude, Cursor, and any MCP-compatible AI client.

Get Started Free View on npm

✨ This page was created entirely using the Odoo Surface MCP — an AI agent wrote the content, injected the snippets, and saved the view through natural language commands, without ever opening the Odoo website editor.