
nh-odoo
Natural Heroes Odoo integration with MCP server and Odoo 19 documentation
- version
- 0.1.0
Install
/plugin install nh-odoo@workflows-marketplaceRun it inside Claude Code after adding the marketplace with /plugin marketplace add Natural-Heroes/workflows.
Contents
Discovered from sourceAgents 2
Natural Heroes Odoo
Production Environment
Web URL: https://odoo.naturalheroes.nl
SSH Access:
ssh 22467447@naturalheroes-odoo.odoo.com
Odoo.sh Dashboard: https://www.odoo.sh/project/naturalheroes-odoo
Common SSH Commands
# List installed modules
ssh 22467447@naturalheroes-odoo.odoo.com "psql -c \"SELECT name, state FROM ir_module_module WHERE state='installed' ORDER BY name;\""
# Check Odoo version
ssh 22467447@naturalheroes-odoo.odoo.com "psql -c \"SELECT latest_version FROM ir_module_module WHERE name='base';\""
# Check specific module version
ssh 22467447@naturalheroes-odoo.odoo.com "psql -c \"SELECT name, latest_version FROM ir_module_module WHERE name='mcp_server';\""
MCP Server
The MCP server module is installed on production. Test endpoints:
# Health check (no auth required)
curl -s https://odoo.naturalheroes.nl/mcp/health
# Other endpoints require API key via X-API-Key header
Available REST endpoints:
/mcp/health- Health check (no auth)/mcp/system/info- System info (requires auth)/mcp/models- List enabled models (requires auth)/mcp/auth/validate- Validate API key
Odoo 19 Documentation
Use Context7 MCP server to look up Odoo 19 documentation:
- First resolve library ID:
resolve-library-idwith libraryName "odoo" - Then query docs:
query-docswith the resolved library ID
Example queries:
- "How to create a wizard in Odoo 19"
- "Odoo 19 ORM methods"
- "Odoo 19 security groups and record rules"
Local Development
# Start development environment
docker compose up -d
# View logs
docker compose logs -f odoo
# Restart after code changes
docker compose restart odoo
# Update a module
docker compose exec odoo odoo -d <database-name> -u <module-name> --stop-after-init
# Access Odoo shell
docker compose exec odoo odoo shell -d <database-name>
Local access:
- Odoo Web UI: http://localhost:8069
- PostgreSQL: localhost:5433 (user: odoo, password: odoo)
Module Structure
module_name/
├── __init__.py # Import models, controllers, wizards
├── __manifest__.py # Metadata: name, version, depends, data files
├── models/ # ORM models
├── views/ # XML: forms, trees, search, actions, menus
├── security/
│ ├── ir.model.access.csv # Model CRUD permissions per group
│ └── security.xml # Groups, record rules
├── data/ # Seed/demo data (XML)
├── wizards/ # Transient models for UI wizards
├── static/ # JS, CSS, images
├── tests/ # Python unittest-based tests
└── i18n/ # Translation files (*.po)
Naming Conventions
| Element | Format | Example |
|---|---|---|
| Module | snake_case | cosmetic_formulation |
| Model | dotted.lowercase | cosmetic.formula |
| Field | snake_case | is_template, formula_line_ids |
| View XML ID | module.view_model_type | module.view_formula_form |
| Version | {odoo}.{major}.{minor}.{patch} | 19.0.1.0.3 |
Natural Heroes Odoo Plugin
Claude Code plugin for working with the Natural Heroes Odoo instance.
Features
- Odoo 19 Documentation - Context7 MCP server for up-to-date Odoo 19 docs
- Production Reference - Quick access to prod URL, SSH commands, and MCP endpoints
- Development Guide - Local docker commands and module structure conventions
MCP Servers
| Server | Purpose |
|---|---|
context7 | Odoo 19 documentation lookup |
Usage
Odoo Documentation
Ask Claude about Odoo 19 features and it will use Context7 to look up current documentation:
- "How do I create a wizard in Odoo 19?"
- "What are the ORM methods available in Odoo 19?"
- "How do security groups work in Odoo?"
Production Access
The plugin provides reference info for:
- Production URL: https://odoo.naturalheroes.nl
- SSH access for database queries
- MCP server endpoints
Prerequisites
uvxinstalled (for Context7 MCP server)
MCP servers 1
Sponsors
Details
- Marketplace
- Natural-Heroes/workflows
- Source
- plugins/nh-odoo
- Author
- Natural Heroes
- Category
- Development