MCP Tools Reference

All tools are accessible via MCP clients (Cursor, Cline, Amp, etc.) and the CLI (oduflow call). A subset is also available via the REST API.

Tool	Lock	Description
Environment Management
create_environment	✓	Provision an Odoo environment for a branch (clone, DB, container, filestore); optional env_vars injects container environment variables
delete_environment	✓	Tear down all resources for a branch
list_environments		List all managed environments with status and URLs
get_environment_info		Full environment details: DB name, URL, repo, image, template, extra addons, workspace, container status, CPU/RAM stats
start_environment		Start a stopped environment
stop_environment		Stop a running environment
restart_environment		Restart the Odoo container
update_environment	✓	Re-create the container, preserving DB and filestore; optional odoo_image switches the image and env_vars replaces the container environment variables
Odoo Operations
pull_and_apply	✓	Git pull + smart analysis → auto install/upgrade/restart
install_odoo_modules	✓	Install Odoo modules (-i)
upgrade_odoo_modules	✓	Upgrade Odoo modules (-u)
run_odoo_tests	✓	Run Odoo tests for specific modules
get_environment_logs		Retrieve recent container logs
run_odoo_command	✓	Execute an arbitrary shell command inside the Odoo container
run_odoo_shell	✓	Execute Python code in the Odoo shell context with full ORM access
read_file_in_odoo		Read a text file or list a directory inside the Odoo container. Supports line ranges (e.g. "1:50")
write_file_in_odoo	✓	Write a text file inside the container (CSV imports, scripts, configs)
search_in_odoo		Search for a pattern (fixed-string grep) in files inside the Odoo container
http_request_to_odoo		Make an HTTP request to the running Odoo instance (test controllers, JSON-RPC, REST)
list_installed_modules		List Odoo modules and their states with name/state filtering
run_db_query	✓	Execute a SQL query against the environment's PostgreSQL database
reset_admin_password	✓	Reset the admin user password in the Odoo database (default: "test")
connect_as_user	✓	Mint a passwordless Odoo login session for a user (by login or id) and return the session_id cookie + URL — hand to Playwright to skip the login form and test as any role (incl. portal)
read_output		Read from a cached tool output by ID (paginate, grep, errors, tail)
Template Management
save_as_template	✓	⚠️ Save a branch DB + filestore as a new template
list_templates		List available template profiles
delete_template	✓	⚠️ Delete a template profile (DB + files)
rename_template	✓	Rename a template (directory + PostgreSQL template DB); refused if any environment uses it
import_template_from_odoo	✓	Import a template from a running Odoo instance via database manager API; optional without_filestore requests a database-only PostgreSQL custom dump
refresh_template	✓	⚠️ Re-apply a template's filestore to live overlay environments (preserves env changes by default; reset_env_changes=True discards them — destructive)
attach_filestore	✓	Attach or replace a template filestore from a local directory, archive, rsync:// URL, or SSH rsync source; normalizes wrapper paths and preserves live env changes by default
Auxiliary Services
create_service	✓	Create a managed service with exactly one exposure model: catch-all port, or restricted Traefik routes (path, backend port, optional strip_prefix). The two parameters are mutually exclusive; port remains required outside Traefik
delete_service	✓	Stop and remove a service container
restart_service		Restart a service container
update_service	✓	Preflight configuration, pull the latest image and/or change settings. routes replaces the complete allowlist; use routes=[] with port only when switching back to catch-all mode
list_services		List all managed service containers
get_service_info		Full live state of a single service (image+digest, port/routes, hostname, host_mode, volumes, env, capabilities, restart count, preset). Call before recreating it
get_service_logs		Retrieve service container logs
run_service_command		Execute a shell command inside a service container
Volumes
create_volume	✓	Create a named Docker volume for use with services
list_volumes		List all managed Docker volumes and their usage by services
inspect_volume		Get detailed information about a specific volume
delete_volume	✓	Delete a managed Docker volume (fails if in use)
read_file_in_volume		Read a text file or list a directory inside a Docker volume
write_file_in_volume	✓	Write a text file inside a Docker volume
search_in_volume		Search for a pattern (fixed-string grep) in files inside a Docker volume
delete_file_in_volume	✓	Delete a file or directory inside a Docker volume
Service Presets
list_service_presets		List saved service presets (configurations that can be restored)
restore_service	✓	Restore a service from a saved preset
delete_service_preset	✓	Remove a saved service preset
Repository Auth
setup_repo_auth	✓	Cache git credentials for a private repository
Extra Addons
add_extra_repo	✓	Clone an extra addons repository (e.g. Odoo Enterprise) for use with environments
list_extra_repos		List all cloned extra addons repositories
update_extra_repo	✓	Fetch latest changes from the remote for an extra addons repository
delete_extra_repo	✓	Delete a cloned extra addons repository
Agent Instructions
get_agent_instructions		Get AI agent instructions for using Oduflow MCP tools
get_odoo_development_guide		Get Odoo development standards guide for a specific version (15–19)

Locking

Tools marked with ✓ acquire a per-branch or per-team lock. Operations on different branches run in parallel. If another operation on the same branch (or team, for team-level tools) is already in progress, the call is rejected with BusyError.