Odoo Surface Mcp
Connects Claude to any Odoo 17+ instance with the exact permissions of the authenticated user. Exposes a layered tool surface: discovery to map models and relations, planning tools to check record state and available actions, and intent tools for CRUD, workflow execution, website page editing, translations, and attachments. The architecture enforces browser parity through ACL checks and uses a guidance layer of markdown skills and workflows the agent consults before multi-step operations. Supports API key auth and multiple instance configs for dev/staging/prod setups. Reach for this when you need Claude to automate Odoo data entry, content updates, or workflow orchestration without building custom endpoints.
- GitHub stars
- 2
- tools
- 36
- auth
- Secret needed
- transport
- STDIO
- env vars
- 4
- last updated
- Oct 3, 2026
Tools
36 toolsPublic tool metadata for what this MCP can expose to an agent.
list_skillsLists available skills (Layer 0 guidance).
Lists available skills (Layer 0 guidance).
No parameter schema in public metadata yet.
get_skills
No parameter schema in public metadata yet.
find_skill
No parameter schema in public metadata yet.
list_workflows
No parameter schema in public metadata yet.
get_workflows
No parameter schema in public metadata yet.
get_models
No parameter schema in public metadata yet.
get_model_actions
No parameter schema in public metadata yet.
get_model_interface
No parameter schema in public metadata yet.
get_available_actions
No parameter schema in public metadata yet.
list_records
No parameter schema in public metadata yet.
get_record
No parameter schema in public metadata yet.
search_records
No parameter schema in public metadata yet.
read_group
No parameter schema in public metadata yet.
get_fields
No parameter schema in public metadata yet.
get_defaults
No parameter schema in public metadata yet.
get_filters
No parameter schema in public metadata yet.
list_pages
No parameter schema in public metadata yet.
get_page_arch
No parameter schema in public metadata yet.
list_snippets
No parameter schema in public metadata yet.
get_snippet
No parameter schema in public metadata yet.
list_attachments
No parameter schema in public metadata yet.
download_binary
No parameter schema in public metadata yet.
fetch_and_upload
No parameter schema in public metadata yet.
translation_get
No parameter schema in public metadata yet.
translation_update
No parameter schema in public metadata yet.
translation_audit
No parameter schema in public metadata yet.
create
No parameter schema in public metadata yet.
update
No parameter schema in public metadata yet.
execute_action
No parameter schema in public metadata yet.
archive
No parameter schema in public metadata yet.
post_message
No parameter schema in public metadata yet.
schedule_activity
No parameter schema in public metadata yet.
create_page
No parameter schema in public metadata yet.
set_page_arch
No parameter schema in public metadata yet.
set_page_visibility
No parameter schema in public metadata yet.
upload_binary
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
ODOO_URL*Odoo instance URL (e.g. https://myodoo.com)
ODOO_DB*Odoo database name
ODOO_USERNAME*Odoo login username
ODOO_PASSWORD*secretOdoo login password
Readme
OdooSurface MCP
User-equivalent Odoo access for AI agents — what the authenticated user can do in their browser, nothing more.
Prerequisites
- Node.js 18+ (ships with
npx— no extra install needed) - A running Odoo instance (15.0+, CE or EE) — per-version behaviour of every call: docs/compatibility.md
- An MCP-compatible client (VS Code, Claude Desktop, Claude Code, Cursor, …)
Configure your MCP client
Add this to your MCP client config (e.g. Claude Desktop claude_desktop_config.json):
Details
- Repository
- github.com/solutionsunity/odoo-surface-mcp
- Package
@suco/odoo-surface-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active