CRUD & Search
Full XML-RPC / JSON-RPC coverage with live refresh bus.
odoo_search
Search for record IDs matching a domain filter.
Parameters & use cases
Parameters
model— model name (e.g. 'res.partner')domain— Odoo domain listlimit,offset,order
Use cases
- "Find all draft invoices for partner X"
- "Last 10 sale orders posted this month"
- "All active users with stock group"
Example
odoo_search(model='res.partner',
domain=[['is_company','=',true],['country_id.code','=','BG']],
limit=50, order='name')
odoo_read
Read specific records by IDs with selected fields.
Parameters & use cases
Use cases
- "Read full partner record by ID"
- "Compare 2 records field-by-field"
odoo_read(model='sale.order', ids=[1,2,3],
fields=['name','partner_id','amount_total','state'])
odoo_search_read
Search + Read in one call. Most efficient for "find and display" flows.
Parameters & use cases
Use cases
- "List all invoices this quarter with amounts"
- "Dashboard queries"
odoo_search_read(model='account.move',
domain=[['state','=','posted']], fields=['name','amount_total'], limit=20)
odoo_search_count
Efficient count without loading records.
odoo_create
Create one or many records. Triggers claude_terminal/refresh_list bus notification so open views update live.
Use cases
- "Create a new vendor bill from scanned PDF"
- "Bulk create contacts from CSV"
odoo_write
Update existing records. Triggers claude_terminal/refresh_field so open form views flash the changed fields.
odoo_unlink
Delete records. Respects Odoo's access rules and _unlink_except_* constraints.
odoo_execute
Call any model method (execute_kw). Entry point for workflow actions: action_post, action_confirm, button_validate, etc.
Use cases
- "Post all draft invoices created today"
- "Confirm sale order + pick + validate picking in sequence"
odoo_execute(model='account.move', method='action_post', args=[[id1, id2]])
odoo_message_post
Post a message to any record's chatter (supports Markdown → HTML, attachments, mention users).
odoo_refresh
Force refresh of a user's open Odoo tab after Claude writes data. Uses bus.bus channel.
odoo_report
Run any ir.actions.report. Returns base64 PDF or HTML.
Introspection
Inspect the schema without filesystem access.
odoo_fields_get
Get field definitions for a model — names, types, relations, labels, translate attribute.
Use cases
- "Which fields on account.move are computed?"
- "Find all many2one fields pointing to res.partner"
odoo_list_models
List all ir.model records with filter pattern. Shows transient, abstract, regular models.
odoo_module_info
Detailed module info: RPC state + filesystem location (OCA, EE, custom repos) + manifest + dependencies + install status.
odoo_version
Server version + protocol version. Used for feature detection (e.g. JSONB translations require Odoo 16+).
Translations NEW 2.10
Multi-language field management — version-aware, auto-ZWSP for identical values.
odoo_list_translatable_fields
Discovers which fields on a model are translatable and classifies each.
Parameters & use cases
Classifications
simple—translate=True(Char/Text/Selection)html—translate=html_translate(blog.post.content, product.website_description)xml—translate=xml_translate(ir.ui.view.arch_db)callable— other truthy (custom translate function)
Use cases
- "Which fields on blog.post can I translate?"
- "Find all html_translate fields on product.template"
odoo_list_translatable_fields(model='blog.post')
→ 9 fields: name, subtitle, teaser, teaser_manual (simple);
content (html); website_meta_title, seo_name... (simple)
odoo_get_field_translations
Read current per-lang translations for a field. Auto-detects kind and uses the right API (16+ native JSONB, <16 ir.translation fallback).
odoo_translate_field
Writes translations for simple translate=True fields (name, subtitle, teaser). Validates lang activation. Version-oriented.
Use cases
- "Set Bulgarian translation for blog post title"
- "Translate product name to 3 languages at once"
- "Clear a stale translation (pass null)"
odoo_translate_field(model='blog.post', res_id=180,
field_name='subtitle',
translations={'bg_BG': 'Как премахването влияе върху счетоводството'})
odoo_translate_html
Writes translations for html_translate / xml_translate fields. Three modes:
Modes & use cases
Modes
extract— read-only; returns canonical terms as Odoo's engine sees them (HTML blocks with inline tags preserved)terms— direct{lang: {src_term: tr_term}}map; precisereplace—{lang: full_html}; delegated to Odoo ORM viawrite()with lang context
Auto-ZWSP fix
When a target-lang value equals the source, Odoo silently drops it (treated as "untranslated"). This tool automatically prefixes U+200B (zero-width-space) to keep it stored as "translated, kept intentionally" — avoiding the website editor's "translate" indicator.
Use cases
- "Translate a full blog article keeping existing HTML structure"
- "Swap one specific term across 3 languages"
- "Extract what terms need translation before sending to a translator"
odoo_translate_html(model='blog.post', res_id=180,
field_name='content', mode='replace',
translations={'bg_BG': '<section>...full BG html...</section>'})
Website Snippets NEW 2.10
lxml-based HTML mutation with xpath substitutions for blog posts, pages, product descriptions, menus.
odoo_website_list_snippets
List available Odoo snippet templates (ir.ui.view with key like website.s_*).
Use cases & categories
Categories inferred
structure— s_banner, s_kickoff, s_cover, s_introcontent— s_text_block, s_cards_grid, s_three_columns, s_cta_carddynamic— s_dynamic_snippet_*, s_blog_posts, s_productseffect— s_progress_bar, s_countdown, s_parallax
Filters
category— filter by inferred categorymodule— website, website_blog, website_sale, website_forumsearch— substring in key or name
odoo_website_list_page_snippets
List snippets currently on a target HTML field. Parses with lxml. Detects by both data-snippet attribute AND first s_* class (Odoo strips data-snippet on some saves).
Returns
index,xpath,data_snippet,data_nametext_preview— first 150 chars of visible texthas_background,background_url— detected from style attribute
odoo_website_add_snippet
Fetches snippet arch from ir.ui.view, extracts root element, applies pre-insertion substitutions, inserts at position.
Positions & examples
Positions
end— after last element (default)begin— before first elementafter/before/replace— relative toanchor_xpath
Example — add CTA at end with custom heading
odoo_website_add_snippet(
model='blog.post', res_id=180, field_name='content',
snippet_key='website.s_cta_card', position='end',
substitutions={
'.//h2': 'Need help with your Odoo migration?',
".//a[contains(@class,'btn')]/@href": 'https://yoursite.com/contact',
})
odoo_website_update_snippet
Update existing snippet content on target. Locates via snippet_xpath, applies substitutions relative to it.
Substitution syntax
{'.//h2': 'New Title'}— text replace{'.//img/@src': 'https://...'}— attribute set{'./div/@style:background-image': 'url(...)'}— single CSS property (preserves other style props)
Example — swap banner background
odoo_website_update_snippet(
model='blog.post', res_id=180, field_name='content',
snippet_xpath='/div/section[1]',
substitutions={
'./div/@style:background-image': 'url(/web/image/67341)',
'./div/@style:background-size': 'cover',
'./div/@style:min-height': '420px',
})
odoo_website_remove_snippet
Remove snippet at xpath. Returns preview of removed HTML for audit.
Web Session
Cookie-based HTTP access. Works through Cloudflare — no XML-RPC needed.
odoo_web_login
Login via /web/session/authenticate, persist cookie session.
odoo_web_logout
Close session and invalidate cookies.
odoo_web_call
Call any web endpoint (/web/dataset/call_kw, /web/search, etc.)
odoo_web_read
Read via web endpoint — handles studio fields, computed specs.
odoo_web_export
Download CSV/XLSX export of any recordset (uses /web/export).
odoo_web_report
Render report via web controller — supports JS-rendered reports (Account reports, Payroll).
odoo_web_request
Raw HTTP request with cookie auth. Escape hatch for any endpoint.
Connections & Auth
Multi-tenant aliases, TOFU cert pinning, user profiles.
odoo_connect
Register a named Odoo connection (alias, URL, DB, API key, protocol, verify_ssl).
odoo_connections
List all registered connections for the current user.
odoo_disconnect
Remove a connection alias.
odoo_cert_info
Show pinned self-signed cert metadata (issuer, subject, fingerprint, expiry).
odoo_cert_refresh
Re-pin self-signed cert (TOFU — trust-on-first-use). Use when rotating certs.
user_connection_add
Add connection to a specific user's profile (admin-scoped).
user_connection_list
List connections of any user.
user_connection_activate
Set a connection as "default" for session tool calls.
user_connection_delete
Remove connection from user profile.
who_am_i
Current user context — name, active profile, unified-auth headers.
identify
Low-level session-slot registration (stdio-compat and unified-auth).
open_connection_manager
Launch local Qt GUI for managing connections (from within the MCP session).
Attachments & Files
Binary data pipeline including vision-based invoice OCR.
odoo_attachment_upload
Upload file as ir.attachment with optional res_model + res_id linking. Supports base64 or URL source.
odoo_attachment_download
Download attachment content. Returns base64 or streams.
public_access_download
Download via public URL (/web/content/) — works for public attachments without auth.
public_access_image
Fetch image via /web/image/ with size/resize parameters.
Reporting
PDF, XLSX, HTML reports on any model.
odoo_report
Run any ir.actions.report. Returns base64 PDF or HTML.
public_access_report_pdf
Render PDF via public URL (/report/pdf/).
public_access_report_xlsx
Render XLSX export.
public_access_report_html
Render HTML — useful for embedding in emails.
public_access_export_csv
CSV export via public URL.
public_access_export_xlsx
XLSX export via public URL.
Portal & Public Access
Headless customer portal access.
public_access_portal_home
Customer portal home — dashboard overview.
public_access_portal_orders
Sale orders visible to the portal user.
public_access_portal_invoices
Invoices + payment status.
public_access_portal_purchases
Purchase orders + RFQs.
public_access_portal_tickets
Helpdesk tickets (if module installed).
public_access_shop
e-Commerce shop listing + product details.
public_access_sitemap
Website sitemap for SEO audits.
public_access_barcode
Barcode scanner entry point (warehouse app).
Bulgaria Localization
Fiscal position tax action maps tailored for НАП compliance.
odoo_fp_list
List all fiscal positions in the current company.
odoo_fp_details
Detailed view of a fiscal position — tax mappings, account mappings, narration template.
odoo_fp_types
Enumerate l10n_bg fiscal position types (standard, customs, protocol, private_use).
odoo_fp_configure
Configure a fiscal position action: target tax, replacement account, narration template, customs_rate coefficient.
odoo_fp_remove_action
Remove a specific tax action from a fiscal position.
AI Tokenizer
Qdrant + Ollama vector embeddings per Odoo record.
ai_tokenize_record
Embed a single record into Qdrant. Generates content summary + embedding via Ollama (nomic-embed-text default).
ai_tokenize_collection
Bulk embed all records of a model. Respects ai.pipeline.step filters.
ai_search_similar
Semantic search — find records similar to a query or another record via cosine distance.
ai_list_documents
List embedded docs in a Qdrant collection with their payloads.
ai_collection_info
Qdrant collection metadata — vector dim, points count, config.
Memory System
Per-user, shared, and licensed memory packs.
memory_read
Read a memory file from any scope (user / shared / licensed).
memory_write
Create or update a memory file. Auto-classifies scope based on prefix.
memory_list
List all memory files with metadata.
memory_share
Promote user memory to shared / licensed scope. Controls distribution.
memory_pull
Pull memory on session start — merges shared + user into session context.
memory_delete
Remove a memory file.
Google Workspace
Gmail, Calendar, Drive via OAuth.
google_auth / google_auth_status
Start OAuth flow and check status.
google_gmail_search / read / send
Gmail full-text search, read messages, send new/replies with attachments.
google_gmail_labels
List Gmail labels; apply/remove labels on threads.
google_calendar_list / events
List calendars; query events in range.
google_calendar_create / update / delete_event
CRUD on calendar events.
Telegram
Full MTProto client, not just bot API.
telegram_configure
Set API ID + hash + phone for this user's profile.
telegram_auth
Run login flow — SMS code verification.
telegram_auth_status
Check current session state.
telegram_search_contacts
Search your contact list by name or phone.
telegram_get_dialogs
List recent conversations (DMs, groups, channels).
telegram_get_messages
Fetch messages from a specific dialog.
telegram_send_message
Send text / media to a contact / group / channel.
SSH & Git
Remote command execution and raw git access.
ssh_execute
Run a command on a remote server via SSH. Supports SSH agent forwarding for passwordless git on remote.
git_remote
Query git remote metadata — branches, tags, last commit, ahead/behind status.
github_api
Raw GitHub API passthrough for unsupported endpoints (escape hatch).
OCA & Odoo Enterprise
Module ecosystem management.
oca_search
Search local OCA repos for a module by name, dependency, or code pattern.
oca_clone_repo / oca_clone_all
Clone a specific repo or the full OCA constellation.
oca_update / oca_status
Pull latest changes, show dirty repos.
oca_deploy / oca_link
Deploy / symlink modules into an Odoo instance's addons path.
oca_gen_readme / icon / table / requirements
Module metadata generators — README.rst from fragments, icon.png from template, account tag table, requirements.txt.
oca_changelog / migrate / fix_website
Newsfragment changelog, version migration (16→18), website theme fixes.
ee_search / clone / deploy / link / unlink
Enterprise repo management — selective EE addon inclusion in CE-only addons paths.
ee_depends / ee_modules
Dependency tree and module listing for EE.
ee_oca_conflicts / ee_oca_recommend
Detect conflicts between EE and OCA modules; recommend OCA alternatives.
ee_license_status / ee_token_check
Validate EE license and API token.
ee_update
Pull latest EE module code.
Portainer & Docker
Full Portainer API coverage.
listStacks / createStack / updateStack
Stack lifecycle — create from compose, update with new env/content, support for pullImage.
listEnvironments / listTeams / listUsers
Enumerate Portainer resources.
createAccessGroup / addEnvironmentToAccessGroup
Access control — group environments, assign teams/users.
createEnvironmentGroup / createEnvironmentTag
Organizational grouping + tagging for multi-environment deployments.
createLocalStack / startLocalStack / stopLocalStack / deleteLocalStack
Manage local Docker-compose stacks from inside Portainer.
dockerProxy / kubernetesProxy
Raw Docker API / Kubernetes API proxy — when you need something Portainer doesn't expose as a named endpoint.
getStackFile / getLocalStackFile / updateLocalStack
Read / update stack compose content + env.
getSettings
Portainer instance global settings.
GitHub
Official GitHub MCP server — 36 tools.
search_code / search_issues / search_pull_requests / search_repositories / search_users
Full-text GitHub search.
list_commits / get_commit / list_branches / list_tags / get_tag
Git history traversal.
list_issues / issue_read / list_pull_requests / pull_request_read
Issues and PR metadata.
get_file_contents / get_repository_tree
Read files + directory listing.
list_discussions / get_discussion / get_discussion_comments / list_discussion_categories
GitHub Discussions.
list_releases / get_latest_release / get_release_by_tag
Releases metadata.
actions_list / actions_get / get_job_logs
Actions workflow runs + logs.
list_gists / get_gist
Gist access.
get_label / list_label / get_me / list_starred_repositories
Labels, current user metadata, starred repos.
Filesystem
Sandboxed filesystem for AI agents — scoped to allowed directories.
read_file / read_text_file / read_media_file / read_multiple_files
Various read modes — text, binary, multiple at once.
write_file / edit_file / move_file
Create, edit, relocate.
create_directory / list_directory / list_directory_with_sizes / directory_tree
Directory operations.
search_files / get_file_info
Find by pattern, stat info.
list_allowed_directories
Report sandbox boundaries.