diff --git a/blog/index.json b/blog/index.json index 6867ab1..7eb1d8d 100644 --- a/blog/index.json +++ b/blog/index.json @@ -1,5 +1,14 @@ { "posts": [ + { + "id": "three-ways-integrate-odoo-hermes", + "date": "2026-06-20", + "area": "guide", + "agent": "hermes", + "headline": "3 Ways to Integrate Odoo and Hermes Agent", + "teaser": "Direct XML-RPC, MCP server, or custom Hermes skill \u2014 three proven approaches to connect Odoo with Hermes Agent. Setup time, trade-offs, and when to use each.", + "link": "blog/posts/three-ways-integrate-odoo-hermes.html" + }, { "id": "speed-run-n8n-skill", "date": "2026-06-18", diff --git a/blog/posts/three-ways-integrate-odoo-hermes.html b/blog/posts/three-ways-integrate-odoo-hermes.html new file mode 100644 index 0000000..4f6aae8 --- /dev/null +++ b/blog/posts/three-ways-integrate-odoo-hermes.html @@ -0,0 +1,341 @@ + + + + + + + + 3 Ways to Integrate Odoo and Hermes Agent — derez.ai Blog + + + + + + + + + + + + + + + +
+ ← Back to Blog +

3 Ways to Integrate Odoo and Hermes Agent

+
+ June 20, 2026 + guide + odoo + hermes +
+ +

+ Odoo is the most popular open-source ERP in the world — CRM, sales, inventory, accounting, all in one system. + Hermes Agent is an open-source AI agent framework. Put them together and your agent can query customer records, + check inventory levels, create leads, generate invoices, and pull sales reports — all through natural language. +

+

+ There are three proven ways to connect the two. Each has different trade-offs in setup speed, + flexibility, and ongoing maintenance. This guide walks through all three so you can pick the right one. +

+ +
+

Already know which approach you want? The detailed speed runs are here: + Direct API, + MCP server, and + Direct vs MCP comparison.

+
+ +

At a Glance

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
ApproachSetup TimeBest ForComponents
1. Direct API~3 minutesSingle-ERP setups, productionHermes + Odoo only
2. MCP Server~5 minutesMulti-tool agents, standardizationHermes + mcp-server-odoo + Odoo
3. Custom Skill~15 minutesComplex workflows, custom logicHermes + custom SKILL.md + Odoo
+ + +
+
⚡ Fastest — 3 min
+

Method 1: Direct API Integration (XML-RPC)

+
+
Setup: ~3 minutes
+
Latency: 1 hop (agent → Odoo)
+
Security: Dedicated Odoo user
+
Maintenance: None
+
+

The simplest approach. You create a dedicated Odoo user with restricted permissions, paste the connection details into Hermes, and your agent calls the Odoo XML-RPC API directly.

+

How it works: Hermes Agent has built-in Odoo tool support. When you configure the connection once, the agent can search, read, create, write, and unlink records on any Odoo model — CRM leads, partners, products, sales orders, invoices, and more.

+ +

Setup

+
    +
  1. Create an Odoo API key — in your Odoo instance, generate a new API key under Settings → Users → Technical
    2. +
  2. Set the Hermes Odoo config — Add your Odoo URL, database, username, and API key to Hermes' config.yaml
    3. +
  3. Start Hermes — The Odoo tools are automatically available in every session
    4. +
+ 
# Hermes config.yaml snippet
+odoo:
+  url: "https://your-instance.odoo4projects.com"
+  db: "your-database"
+  user: "agent@company.com"
+  api_key: "your-api-key"
+  readonly: true
+ +

When to use this

+ + +

Deep dive: Speed Run: Create an Odoo Community Agent from Zero

+
+ + +
+
🚀 Standard — 5 min
+

Method 2: MCP Server (Model Context Protocol)

+
+
Setup: ~5 minutes
+
Latency: 2 hops (agent → MCP → Odoo)
+
Security: MCP transport layer
+
Maintenance: Server process
+
+

The MCP approach inserts a translation layer between Hermes and Odoo. The mcp-server-odoo project (315+ GitHub stars, actively maintained) exposes Odoo models as MCP tools that Hermes can discover and call.

+

How it works: You run the MCP server locally on the same machine as Hermes. It listens on an HTTP port and translates MCP tool calls into Odoo XML-RPC requests. Hermes discovers the available tools automatically when you register the server.

+ +

Setup

+
    +
  1. Clone the server — git clone https://github.com/ivnvxd/mcp-server-odoo.git
    2. +
  2. Set environment variables — URL, database, username, API key
    3. +
  3. Start the server — uvx mcp-server-odoo (port 8000, streamable-http transport)
    4. +
  4. Register with Hermes — hermes mcp add odoo --url http://localhost:8000/mcp
    5. +
  5. Start Hermes — Odoo tools appear automatically
    6. +
+ 
#!/usr/bin/env bash
+export ODOO_URL="https://your-instance.odoo4projects.com"
+export ODOO_DB="your-database"
+export ODOO_USER="agent@company.com"
+export ODOO_API_KEY="your-api-key"
+export ODOO_READONLY=1
+export ODOO_MCP_TRANSPORT=streamable-http
+export ODOO_MCP_PORT=8000
+export ODOO_YOLO=read
+
+uvx mcp-server-odoo
+ +

When to use this

+ + +

Deep dive: Speed Run: Connect Hermes Agent to Odoo via MCP

+
+ + +
+
🔧 Flexible — 15 min
+

Method 3: Custom Hermes Skill

+
+
Setup: ~15 minutes
+
Latency: 1 hop (skill → Odoo)
+
Security: Full control
+
Maintenance: As needed
+
+

The most flexible approach. You write a custom Hermes skill — a SKILL.md file — that defines exactly how the agent communicates with Odoo. This gives you full control over the tools, prompts, and error handling.

+

How it works: Hermes skills are markdown files with YAML frontmatter and a structured body. Your Odoo skill defines tools like search_leads, create_invoice, or check_inventory. Each tool uses terminal() to make curl calls to the Odoo XML-RPC endpoint, and the agent calls these tools by name during the conversation.

+ +

Setup

+
    +
  1. Create SKILL.md — in ~/.hermes/skills/odoo/SKILL.md
    2. +
  2. Define tools — Each tool has a name, description, parameter schema, and command template
    3. +
  3. Load the skill — Add it to your Hermes profile or load it in a session
    4. +
+ 
# Odoo Hermes Skill
+
+## Tools
+
+### search_leads
+Search CRM leads with filters.
+Parameters: domain (list), limit (int, optional)
+Command: `curl -s "$ODOO_URL" -d '{"params": {"model": "crm.lead", "method": "search_read", "args": [{{domain}}], "kwargs": {"limit": {{limit|5}}}}}'`
+
+### create_lead
+Create a new CRM lead.
+Parameters: name (string), email (string, optional), phone (string, optional)
+Command: `curl -s "$ODOO_URL" -d '{"params": {"model": "crm.lead", "method": "create", "args": [{"name": "{{name}}", "email_from": "{{email}}", "phone": "{{phone}}"}]}}'`
+ +

When to use this

+ + +
+

Pro Tip: The skill approach gives you the most control but also the most responsibility. You handle authentication, error handling, rate limiting, and API versioning yourself. For simpler setups, start with Method 1 or 2.

+
+
+ +

Decision Guide

+

Not sure which to pick? Here's a quick flowchart:

+ + +

Security Best Practices

+

Whichever approach you choose, these rules apply:

+ + +

Comparison Table

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FeatureDirect APIMCP ServerCustom Skill
Setup time~3 min~5 min~15 min
Extra processesNoneMCP server daemonNone
Tool discoveryBuilt-inAutomatic (MCP list)Defined in SKILL.md
Custom workflowsLimitedLimitedFull control
Multi-tool agentRequires per-tool setupOne protocol for allPer-skill setup
Security modelOdoo user permissionsMCP transport + Odoo permsOdoo user + skill code
Best forProduction single-ERPMulti-tool MCP stacksCustom agent products
+ +

Can You Run Multiple Methods?

+

Yes. Hermes Agent supports mixed setups — you can use the direct API for Odoo while connecting GitHub and Slack through MCP, and load a custom skill for Odoo-specific workflows on top of that. The methods are not mutually exclusive. Choose the right connection for each backend.

+ +
+

Try It Yourself — First Month Free

+

Deploy a Hermes Agent with any of these Odoo integrations. Use coupon code blog950 for your first month free.

+ Get Your Agent → +
+ +

+ derez.ai — Deploy your AI agent in 5 minutes. · + Direct Odoo Speed Run · + MCP Speed Run · + Direct vs MCP +

+
+ + \ No newline at end of file