# OdooSurface MCP server

> Enables AI agents to perform CRUD operations, manage websites, translations, and workflows within an Odoo instance.

- Repository: https://github.com/solutionsunity/odoo-surface-mcp
- Page: https://hostedmcp.org/servers/solutionsunity/odoo-surface-mcp
- Transport: stdio
- Stars: 2
- License: Apache-2.0
- Latest version: 0.6.1

## Install

### Claude Code

```sh
claude mcp add --env 'ODOO_PASSWORD=<YOUR_ODOO_PASSWORD>' --env 'ODOO_DB=<ODOO_DB>' --env 'ODOO_URL=<ODOO_URL>' --env 'ODOO_USERNAME=<ODOO_USERNAME>' odoo-surface-mcp -- npx -y @suco/odoo-surface-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "odoo-surface-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@suco/odoo-surface-mcp"
      ],
      "env": {
        "ODOO_PASSWORD": "<YOUR_ODOO_PASSWORD>",
        "ODOO_DB": "<ODOO_DB>",
        "ODOO_URL": "<ODOO_URL>",
        "ODOO_USERNAME": "<ODOO_USERNAME>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "odoo-surface-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@suco/odoo-surface-mcp"
      ],
      "env": {
        "ODOO_PASSWORD": "<YOUR_ODOO_PASSWORD>",
        "ODOO_DB": "<ODOO_DB>",
        "ODOO_URL": "<ODOO_URL>",
        "ODOO_USERNAME": "<ODOO_USERNAME>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"odoo-surface-mcp","type":"stdio","command":"npx","args":["-y","@suco/odoo-surface-mcp"],"env":{"ODOO_PASSWORD":"<YOUR_ODOO_PASSWORD>","ODOO_DB":"<ODOO_DB>","ODOO_URL":"<ODOO_URL>","ODOO_USERNAME":"<ODOO_USERNAME>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "odoo-surface-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@suco/odoo-surface-mcp"
      ],
      "env": {
        "ODOO_PASSWORD": "<YOUR_ODOO_PASSWORD>",
        "ODOO_DB": "<ODOO_DB>",
        "ODOO_URL": "<ODOO_URL>",
        "ODOO_USERNAME": "<ODOO_USERNAME>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add odoo-surface-mcp --env 'ODOO_PASSWORD=<YOUR_ODOO_PASSWORD>' --env 'ODOO_DB=<ODOO_DB>' --env 'ODOO_URL=<ODOO_URL>' --env 'ODOO_USERNAME=<ODOO_USERNAME>' -- npx -y @suco/odoo-surface-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.odoo-surface-mcp]
command = "npx"
args = ["-y", "@suco/odoo-surface-mcp"]

[mcp_servers.odoo-surface-mcp.env]
ODOO_PASSWORD = "<YOUR_ODOO_PASSWORD>"
ODOO_DB = "<ODOO_DB>"
ODOO_URL = "<ODOO_URL>"
ODOO_USERNAME = "<ODOO_USERNAME>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'ODOO_PASSWORD=<YOUR_ODOO_PASSWORD>' -e 'ODOO_DB=<ODOO_DB>' -e 'ODOO_URL=<ODOO_URL>' -e 'ODOO_USERNAME=<ODOO_USERNAME>' odoo-surface-mcp npx -- -y @suco/odoo-surface-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "odoo-surface-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@suco/odoo-surface-mcp"
      ],
      "env": {
        "ODOO_PASSWORD": "<YOUR_ODOO_PASSWORD>",
        "ODOO_DB": "<ODOO_DB>",
        "ODOO_URL": "<ODOO_URL>",
        "ODOO_USERNAME": "<ODOO_USERNAME>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `ODOO_PASSWORD` | yes | yes | Odoo login password |
| `ODOO_DB` | yes | no | Odoo database name |
| `ODOO_URL` | yes | no | Odoo instance URL (e.g. https://myodoo.com) |
| `ODOO_USERNAME` | yes | no | Odoo login username |
| `ODOO_USER` | no | no |  |

## FAQ

### What version of Odoo is supported?

The server supports Odoo version 15.0 and above, including both Community Edition (CE) and Enterprise Edition (EE).

### How can I use API keys instead of a password?

Users can generate personal API keys in their Odoo account under Preferences > Account Security. Using these keys as the ODOO_PASSWORD is the recommended method as it avoids storing the actual account password.

### Can I connect to multiple Odoo instances at once?

Yes, you can configure multiple named entries in your MCP client config, allowing them to run as independent processes with isolated credentials.
