Alpenglow MCP Connector¶
Connect AI assistants — Claude Desktop, Claude Code, Cursor, VS Code Copilot, or any MCP-compatible client — to your Odoo 19 instance through the Model Context Protocol.
What it does¶
The Alpenglow MCP Connector gives AI assistants structured, permissioned access to your Odoo data. Instead of screen-scraping or brittle API scripts, your AI assistant can search records, read schemas, create and update data, and run reporting queries — all governed by the same access controls your Odoo users already have.
How it works¶
Setup has two sides:
- Server — An Odoo module that manages configuration, access control, rate limiting, and audit logging.
- Client — A small bridge package (
alpenglow-mcp-bridge) that runs locally on your workstation and translates between the MCP stdio protocol and HTTP requests to your Odoo server.
Capabilities¶
| Capability | Description |
|---|---|
| 9 MCP tools | List models, describe schemas, search, read, create, update, delete, aggregate, and execute ORM methods |
| 3 API interfaces | MCP (JSON-RPC 2.0), REST, and XML-RPC proxy — all sharing the same access controls |
| Granular permissions | Per-model CRUD toggles, field allowlists/denylists, record-level domain filters |
| Credential management | Scoped API keys with optional expiration, usage tracking, and one-click revocation |
| Rate limiting | Database-backed sliding window with separate buckets for general and aggregation requests |
| Audit logging | Every operation logged with user, model, duration, IP, and event type |
| Multi-company | Resources and credentials scoped per company with database-level isolation |
Documentation¶
- :material-rocket-launch: **[Getting Started](getting-started.md)**
---
Install the module, run the setup wizard, install the bridge, and connect your AI client in five steps.
- :material-cog: **[Configuration](configuration.md)**
---
Manage resources, credentials, and global settings manually — beyond what the setup wizard covers.
- :material-code-json: **[API Reference](api-reference.md)**
---
MCP tools, REST endpoints, XML-RPC proxy, aggregation operations, and request/response formats.
- :material-shield-lock: **[Security](security.md)**
---
Authentication methods, the 12-step access pipeline, rate limiting, and audit logging.
- :material-wrench: **[Troubleshooting](troubleshooting.md)**
---
Solutions for common connection, authentication, and configuration issues.
Requirements¶
- Odoo 19 (Community or Enterprise)
- Python 3.10+
- The
defusedxmlPython package (server-side) uv/uvxpackage runner (client-side, for the bridge)
License¶
Alpenglow MCP Connector is proprietary software licensed under OPL-1 (Odoo Proprietary License v1.0).