This is a full-featured Odoo ERP integration that gives you both a CLI and a TypeScript library for working with any Odoo instance. The CLI is genuinely useful for quick record lookups, posting chatter notes, and checking module status without writing code. The library wraps Odoo's XML-RPC API with proper TypeScript types and domain-specific helpers for mail, timesheets, attendance, and accounting. Exit codes are well-defined, safety levels are clearly marked (read vs. write vs. destructive), and it handles Odoo's quirks like read/write field asymmetry and multi-company contexts. If you're automating Odoo workflows or just tired of clicking through the web UI, this covers the common cases well.
- skills.sh installs
- 177
- GitHub stars
- 44
- last updated
- Aug 21, 2026
Install
$ npx -y skills add marcfargas/odoo-toolbox --skill odoo --agent claude-codeInstalls into .claude/skills of the current project.
Files
/odoo
Odoo ERP integration. Two ways to work: CLI (fastest for most tasks) and Library (for scripts and automation).
Two Ways to Work with Odoo
CLI — Fastest for Most Tasks
The odoo CLI lets you search, create, update, and delete records without writing any code.
# 1. Verify connection (always do this first)
odoo config check
# 2. Search records
odoo records search res.partner --fields name,email --limit 5
# 3. Create a record
odoo records create res.partner --data '{"name":"Acme Corp"}' --confirm
# 4. Post a note on a record
odoo mail note crm.lead 42 "Called customer" --confirm
Library — For Scripts and Automation
import { createClient } from '@marcfargas/odoo-client';
const client = await createClient(); // reads ODOO_URL, ODOO_DB, ODOO_USER, ODOO_PASSWORD
const partners = await client.searchRead('res.partner', [['is_company', '=', true]], {
fields: ['name', 'email'],
limit: 10,
});
await client.mail.postInternalNote('crm.lead', 42, '<p>Called customer.</p>');
await client.modules.isModuleInstalled('sale');
Quick Start
Step 1: Configure Environment
Sponsors
Details
- Repository
- github.com/marcfargas/odoo-toolbox
- Category
- Automation & Workflows
- First seen
- Jun 3, 2026
