Tool Catalog

197+ MCP tools organized by category. Click a category in the sidebar to jump, or expand any tool card to see parameters, use cases, and an example call.

⇅

CRUD & Search

Full XML-RPC / JSON-RPC coverage with live refresh bus.

14 tools

odoo_search

returns: list[int]

Search for record IDs matching a domain filter.

Parameters & use cases
Parameters
  • model — model name (e.g. 'res.partner')
  • domain — Odoo domain list
  • limit, 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

returns: list[dict]

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

combined

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

returns: int

Efficient count without loading records.

odoo_create

write · fires bus

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

write · fires bus

Update existing records. Triggers claude_terminal/refresh_field so open form views flash the changed fields.

odoo_unlink

write

Delete records. Respects Odoo's access rules and _unlink_except_* constraints.

odoo_execute

method call

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

chatter

Post a message to any record's chatter (supports Markdown → HTML, attachments, mention users).

odoo_refresh

client action

Force refresh of a user's open Odoo tab after Claude writes data. Uses bus.bus channel.

odoo_report

PDF / HTML

Run any ir.actions.report. Returns base64 PDF or HTML.

🔍

Introspection

Inspect the schema without filesystem access.

4 tools

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.

4 tools

odoo_list_translatable_fields

inspector

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

reader

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

simple · write

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

html/xml · 3 modes

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; precise
  • replace — {lang: full_html}; delegated to Odoo ORM via write() 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.

5 tools

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_intro
  • content — s_text_block, s_cards_grid, s_three_columns, s_cta_card
  • dynamic — s_dynamic_snippet_*, s_blog_posts, s_products
  • effect — s_progress_bar, s_countdown, s_parallax
Filters
  • category — filter by inferred category
  • module — website, website_blog, website_sale, website_forum
  • search — 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_name
  • text_preview — first 150 chars of visible text
  • has_background, background_url — detected from style attribute

odoo_website_add_snippet

write

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 element
  • after / before / replace — relative to anchor_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

write

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

write

Remove snippet at xpath. Returns preview of removed HTML for audit.

🔐

Web Session

Cookie-based HTTP access. Works through Cloudflare — no XML-RPC needed.

7 tools

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.

12 tools

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.

4 tools

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.

6 tools

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.

8 tools

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.

5 tools

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.

5 tools

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.

6 tools

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.

11 tools

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.

7 tools

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.

3 tools

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.

25 tools

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.

30 tools

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.

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.

15 tools

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.