MCP Odoo Server

You set up an MCP server that lets AI assistants and other MCP clients interact with Odoo databases. It handles connection, CRUD operations, module management, and administrative tasks through XML-RPC and JSON-RPC, making it easy to automate workflows and integrate Odoo data into your tools.

How to use

To use this MCP server, configure your MCP client to load the Odoo MCP server, then start the MCP process and connect to your Odoo instance. Once connected, you can search, read, create, update, and delete Odoo records, inspect field metadata, manage modules, and verify access rights. Use the client’s MCP configuration to point to the local or remote server and issue the supported operations through your preferred interface.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine.

# 1) Navigate to the MCP server directory
cd mcp-odoo-server

# 2) Install dependencies
npm install

# 3) Build the TypeScript code
npm run build

Configuration and usage notes

Configuration enables your MCP client to locate and start the Odoo MCP server. Use the following configuration in your MCP client to load the server.

{
  "mcpServers": {
    "odoo": {
      "command": "node",
      "args": [
        "/Users/malvernbright/development/Odoo/odoo-17.0+e.20251121/mcp-odoo-server/build/index.js"
      ]
    }
  }
}

Odoo API key setup

To authenticate with your Odoo instance, create an API key for your user. Then use that key as the password when connecting to the Odoo MCP server.

1. Log into your Odoo instance
2. Go to Settings > Users & Companies > Users
3. Open your user record
4. Go to the Preferences tab
5. Click New API Key
6. Copy the generated API key

Available tools

odoo_connect

Connect to an Odoo database using the MCP server to initiate sessions and manage authentication.

odoo_search

Search for record IDs matching criteria within a model using domain filters.

odoo_search_read

Perform a combined search and read to fetch full records with specified fields.

odoo_read

Read specific records by their IDs and retrieve selected fields.

odoo_create

Create new records in a chosen Odoo model with provided values.

odoo_write

Update existing records by IDs with new field values.

odoo_delete

Delete records by IDs from a model.

odoo_fields_get

Retrieve field definitions and metadata for a model.

odoo_execute

Execute arbitrary methods on a model (advanced usage).

odoo_version

Query the Odoo server version and capabilities.

odoo_check_access_rights

Verify user permissions for given operations.

odoo_get_installed_modules

List modules currently installed in the Odoo instance.

odoo_install_module

Install a module by name.

odoo_uninstall_module

Uninstall a module by name.

odoo_upgrade_module

Upgrade a module by name.