Introduction

Model Context Protocol (MCP) Server for Odoo 19.

Connect any MCP-compatible AI agent — Claude, GPT, Gemini, Cursor, and more — directly to your Odoo instance with full CRUD capabilities, enterprise-grade security, configurable rate limiting, and comprehensive audit logging.

Release Status

Current version: 19.0.1.2.0
Last QA gate update: 2026-04-20
Status: Marketplace-ready
Validation scope includes lifecycle tests, auth/transport checks, ACL/multi-company isolation, 120-minute soak profile, and final release-gate smoke runs.

Interactive Demo

You can test the MCP server using any compatible client (Claude Desktop, Cursor, or CLI).

1. Connection Details

Demo URL: https://demo.easymob.net/mcp
Demo API Key: mcp_demo_public_key_2025 (Read-only access)

2. Configuration for Claude / Cursor

Add this to your mcp_config.json or Cursor settings:

{
  "mcpServers": {
    "odoo-demo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://demo.easymob.net/mcp",
        "--header",
        "Authorization: Bearer mcp_demo_public_key_2025"
      ]
    }
  }
}

3. Quick Test via Terminal

Run this command to list available tools on the demo server:

npx mcp-remote https://demo.easymob.net/mcp --header "Authorization: Bearer mcp_demo_public_key_2025"

Features

Core Capabilities

Feature	Description
Streamable HTTP Protocols	MCP 2025 spec with SSE (Server-Sent Events) streams and stateful session management for reliable AI agent communication.
Secure API Authentication	SHA-256 hashed API keys with optional expiry dates. Full key displayed only once at creation; never stored in plaintext.
Rate Limiting	Per-key and global rate limits (requests/minute) with 429 HTTP response codes for protection against abuse.
IP Whitelisting	Restrict API key usage to specific IP addresses for network-level security.
10 Built-in Tools	search, read, create, update, delete, execute_method, find_models, count_records, aggregate, and fields_get.
AI Instruction System	Built-in logic that automatically teaches the AI agent how Odoo works, including business-to-model mapping.
Custom Tool Creation	Write Python tools on-the-fly with safe_eval sandbox and JSON schema validation.
Resource Endpoints	Model-backed REST resources with URI templates for flexible data access patterns.
Configurable Prompts	Template-based prompt system with `{{variable}}` substitution for dynamic AI context.
Audit Logging	Complete request/response logging with configurable retention and auto-cleanup.
Per-Model Access Control	Define CRUD permissions at the model level for fine-grained security.
CORS Support	Configurable allowed origins for cross-domain agent integration.
Multi-Company Support	Respects Odoo’s record rules; safe for multi-tenant deployments.

Built-in Tools in Detail

Tool	Use Cases
find_models	Crucial: Resolves terms like “leads” or “invoices” to their technical names (crm.lead, account.move) automatically.
search_records	Find customers, invoices, products, or any records matching criteria. Use domains, filters, and limits.
read_record	Fetch full details of a specific record by ID for detailed analysis or decision-making.
create_record	Programmatically create new leads, contacts, sales orders, or other records.
update_record	Modify existing records based on agent decisions (e.g., update deal status, customer info).
delete_record	Remove records with proper access control and audit logging.
execute_method	Call custom Odoo methods (e.g., `action_confirm()`) for workflow automation.
count_records	Quickly get the number of records (e.g., “How many open leads do I have?“).
get_model_fields	Allows the AI to “inspect” a model to see which fields are available for reading or writing.
aggregate_records	Performs server-side math (Sums, Averages) grouped by fields (e.g., “Total sales by month”).

Use Cases

AI-Powered Sales Automation
- Agents automatically create and qualify leads from emails/forms
- Update opportunity stages based on customer conversation context
- Suggest next best actions to sales team
- Create follow-up tasks automatically
Customer Data Enrichment
- AI extracts and standardizes customer information
- Auto-fill missing contact details
- Flag duplicate or suspicious records
- Categorize customers by segment automatically
Intelligent Invoice & Order Processing
- AI reads incoming invoices and creates purchase orders
- Validates invoice data against POs
- Auto-match line items and quantities
- Flag discrepancies for human review
HR & Recruitment Automation
- AI-powered candidate screening and ranking
- Auto-generate job applications in the system
- Update interview schedules
- Extract insights from resumes and applications
Supply Chain & Inventory Insights
- Monitor inventory levels across warehouses in real-time
- AI suggests reorder points based on historical demand
- Predict shortages and alert procurement teams
- Optimize stock allocation
Customer Support & Ticketing
- AI creates and prioritizes support tickets from emails
- Routes tickets to appropriate departments
- Searches knowledge base and suggests solutions
- Auto-updates customer communications
Financial Reporting & Analysis
- AI generates custom financial reports on-demand
- Analyzes cash flow and predicts liquidity issues
- Identifies high-value vs. at-risk customers
- Detects unusual transaction patterns