Odoo Assistant MCP Server
by singlefloio.github.singleflo/odoo-assistantv0.2.0
Odoo virtual employee via MCP: query, create, modify records, workflows, PDFs, and activities.
context tax
queued
security
queued
cold start
queued
freshness
Active2d ago
Install Odoo Assistant MCP server
Install in Claude Code
claude mcp add odoo-assistant -e ODOO_BASE_URL='<odoo-base-url>' -e ODOO_API_KEY='<odoo-api-key>' -- uvx odoo-assistantInstall in Cursor
{
"mcpServers": {
"odoo-assistant": {
"command": "uvx",
"args": [
"odoo-assistant"
],
"env": {
"ODOO_BASE_URL": "<odoo-base-url>",
"ODOO_API_KEY": "<odoo-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"odoo-assistant": {
"command": "uvx",
"args": [
"odoo-assistant"
],
"env": {
"ODOO_BASE_URL": "<odoo-base-url>",
"ODOO_API_KEY": "<odoo-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"odoo-assistant": {
"type": "stdio",
"command": "uvx",
"args": [
"odoo-assistant"
],
"env": {
"ODOO_BASE_URL": "<odoo-base-url>",
"ODOO_API_KEY": "<odoo-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"odoo-assistant": {
"command": "uvx",
"args": [
"odoo-assistant"
],
"env": {
"ODOO_BASE_URL": "<odoo-base-url>",
"ODOO_API_KEY": "<odoo-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ODOO_BASE_URL | yes | — | Your Odoo instance URL (e.g. http://localhost:8069) |
| ODOO_DB | — | — | Odoo database name. Optional: discovered automatically when the instance serves exactly one database; required when it serves several (the error names them). |
| ODOO_USER | — | — | Odoo login username. Optional: omitted, the login is discovered from the API key. |
| ODOO_API_KEY | yes | yes | Odoo API key (Odoo 14+ required). Generate under Preferences / My Profile > Account Security > New API Key. Passwords are not accepted. |
| ODOO_MCP_ALLOW | — | — | Methods the agent may call. `*` (default) allows every method not denied; `none` makes the server read-only; or a comma-separated list of `method` or `model:method` entries. |
| ODOO_MCP_DENY | — | — | Methods the agent may never call. A value set here REPLACES the default list, which is unlink,archive,action_cancel,button_cancel,action_reverse,action_draft,mailing.mailing:action_send. |
| ODOO_MCP_ALLOW_UNLINK | — | — | Deletion is the one action that cannot be undone: `yes` lets `unlink` through; nothing else can. |
Freshness
Active — last maintenance signal 2d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-10-07 · 2d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-15 · 24d ago · official registry · v0.2.0
FAQ
›How do I install the Odoo Assistant MCP server in Claude Code?
Run: claude mcp add odoo-assistant -e ODOO_BASE_URL='<odoo-base-url>' -e ODOO_API_KEY='<odoo-api-key>' -- uvx odoo-assistant. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Odoo Assistant require an API key?
Yes. It expects ODOO_BASE_URL, ODOO_API_KEY, of which 1 is a secret.
›Can I use Odoo Assistant as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Odoo Assistant in the official MCP registry?
Yes, as io.github.singleflo/odoo-assistant.