Odoo MCP
An open-source Model Context Protocol server for Odoo 16+ that enables AI agents to search, read, and aggregate records safely. It features gated writes requiring approval tokens, multi-instance routing, and JSON-2 payload generation for future compatibility, all without requiring Odoo-side modules or admin access.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Search and aggregate customer records with unpaid invoices
- Audit custom addons for upgrade risks before moving to new Odoo versions
- Generate JSON-2 payloads to prepare for Odoo 22 XML-RPC removal
- Query multiple Odoo databases for AR/AP aging across a client portfolio
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
odoo-mcp 1.3.0
{
"version": "1.3.0",
"transport": "stdio",
"identifier": "odoo-mcp",
"registryType": "pypi",
"environmentVariables": [
{
"name": "ODOO_URL",
"isRequired": true,
"description": "Odoo server URL, e.g. https://mycompany.odoo.com"
},
{
"name": "ODOO_DB",
"isRequired": true,
"description": "Odoo database name"
},
{
"name": "ODOO_USERNAME",
"isRequired": true,
"description": "Odoo login (email)"
},
{
"name": "ODOO_PASSWORD",
"isRequired": true,
"description": "Odoo password or API key"
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"odoo-mcp": {
"command": "uvx",
"args": [
"odoo-mcp==1.3.0"
],
"env": {
"ODOO_URL": "<YOUR_ODOO_URL>",
"ODOO_DB": "<YOUR_ODOO_DB>",
"ODOO_USERNAME": "<YOUR_ODOO_USERNAME>",
"ODOO_PASSWORD": "<YOUR_ODOO_PASSWORD>"
}
}
}
}Cline
{
"mcpServers": {
"odoo-mcp": {
"command": "uvx",
"args": [
"odoo-mcp==1.3.0"
],
"env": {
"ODOO_URL": "<YOUR_ODOO_URL>",
"ODOO_DB": "<YOUR_ODOO_DB>",
"ODOO_USERNAME": "<YOUR_ODOO_USERNAME>",
"ODOO_PASSWORD": "<YOUR_ODOO_PASSWORD>"
}
}
}
}VS Code
{
"servers": {
"odoo-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"odoo-mcp==1.3.0"
],
"env": {
"ODOO_URL": "<YOUR_ODOO_URL>",
"ODOO_DB": "<YOUR_ODOO_DB>",
"ODOO_USERNAME": "<YOUR_ODOO_USERNAME>",
"ODOO_PASSWORD": "<YOUR_ODOO_PASSWORD>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"odoo-mcp": {
"command": "uvx",
"args": [
"odoo-mcp==1.3.0"
],
"env": {
"ODOO_URL": "<YOUR_ODOO_URL>",
"ODOO_DB": "<YOUR_ODOO_DB>",
"ODOO_USERNAME": "<YOUR_ODOO_USERNAME>",
"ODOO_PASSWORD": "<YOUR_ODOO_PASSWORD>"
}
}
}
}Let your agent find its tools
Find servers like Odoo MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.