odoo-sh-readonly-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ODOO_SH_PROJECT | No | Default repository name to filter results. | |
| ODOO_SH_BASE_URL | No | Base URL of Odoo.sh. Defaults to https://www.odoo.sh | https://www.odoo.sh |
| ODOO_SH_SSH_HOST | No | SSH host for the target Odoo.sh environment (e.g., <project>.dev.odoo.com). Required for SSH-based tools. | |
| ODOO_SH_SSH_PORT | No | SSH port. Defaults to 22. | 22 |
| ODOO_SH_SSH_USER | No | SSH username (e.g., BUILD_ID or branch name). Required for SSH-based tools. | |
| ODOO_SH_SESSION_ID | No | Cookie session_id from www.odoo.sh (required for web API calls). | |
| ODOO_SH_SSH_KEY_PATH | No | Path to the private SSH key. Required for SSH-based tools. | |
| ODOO_SH_SSH_TIMEOUT_MS | No | SSH connection timeout in milliseconds. Defaults to 30000. | 30000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| odoo_sh_overviewA | Get repositories, branches and their environment stage (production/staging/dev) with last build info from the Odoo.sh platform API. Use this first to understand the project layout. Requires ODOO_SH_SESSION_ID. |
| odoo_sh_list_buildsA | List recent builds with their REAL status/result (e.g. success, failed, testing) from the Odoo.sh platform API. Filter by branch name. Requires ODOO_SH_SESSION_ID. |
| odoo_sh_model_fieldsA | Introspect available fields on an Odoo.sh platform model (paas.repository, paas.branch, paas.build, ...). Use this if odoo_sh_list_builds/odoo_sh_overview return unexpected data, then query precisely with odoo_sh_search_read. |
| odoo_sh_search_readA | Run a search_read on a whitelisted Odoo.sh platform model with a custom domain and field list. Read-only escape hatch when the curated tools don't cover a need. Example domain: [["branch_id.name","=","main"]] |
| odoo_sh_logsC | Tail Odoo logs (odoo.log, install.log or pip.log) from the configured Odoo.sh build container via SSH. Read-only. |
| odoo_sh_system_infoA | Hostname, uptime, disk, memory, Python and Odoo version of the configured Odoo.sh build container. Read-only. |
| odoo_sh_databasesA | List PostgreSQL databases and sizes on the configured Odoo.sh build container. Read-only. |
| odoo_sh_statusA | Show which data sources are configured (web API session, SSH) without exposing secrets. Use to diagnose setup issues. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Tools are mostly distinct with clear purposes, though overview and list_builds overlap slightly in build-related information. Overall, each tool targets a specific function and confusion is unlikely.
All tools use the consistent 'odoo_sh_' prefix followed by snake_case verbs/nouns, creating a uniform and predictable naming pattern.
8 tools is a reasonable number for a read-only Odoo.sh management surface, covering key areas without being excessive or sparse.
The set covers critical read-only operations like builds, logs, system info, databases, and model search. It lacks some advanced operations (e.g., deployment history) but for a read-only utility it is well-rounded.