Claude Odoo Builder

Turn Claude Code into an Odoo website builder. One command scaffolds a complete project with tools, workflows, and configuration for designing, building, and deploying pages on your Odoo website.

Disclaimer

By downloading and deploying these files, you take full responsibility. Neither 19 Prince nor Darren are responsible for productivity gains, productivity losses, injury due to falling down rabbit holes, lost sleep, or the annoying conversations you'll feel the need to have about Claude Code.

Seriously, I tried to provide you with some useful tools. I genuinely hope you like them. That said, read the files and be safe out there. You are taking full responsibility for any and all outcomes.

What's Included

Skills

Tools (Python scripts)

Workflows (Markdown SOPs)

Prerequisites

• Claude Code installed
• Python 3.8+
• An Odoo instance with admin access (URL, database name, login email)

Installation

1. Clone this repo:

git clone https://github.com/19prince/claude-odoo-builder.git

2. Copy the skills into your Claude Code skills directory:

cp -r claude-odoo-builder/skills/* ~/.claude/skills/

3. Install Python dependencies:

pip install requests python-dotenv pyyaml

Quick Start

Open Claude Code in your terminal and type:

/new-odoo-project

Claude will ask you for:

1. Project directory — where the project should live
2. Client/project name — a short name for your project
3. Odoo URL — your Odoo instance URL
4. Database name — your Odoo database name
5. Login email — the email you use to log into Odoo
6. Staging or production? — whether you have a separate staging server

Claude creates the project structure and a .env file with your credentials template. You fill in the password yourself — Claude never sees it.

After Setup

Add your password

Open the .env file in your project and fill in ODOO_PASSWORD=:

nano ~/projects/my-website/.env

Verify the connection

Claude automatically tests the connection. If it works, you'll see all your website pages listed with their publish status.

Check the website editor

Log into your Odoo backend, open the website editor, and verify:

• Snippet block thumbnails load without warning icons
• You can drag blocks onto the page
• Text and image toolbars appear when clicking elements

If blocks show orange warning icons, the page arch is missing <div id="wrap" class="oe_structure"> inside the layout call. This is handled automatically by push_page.py — if you see it on an existing page, re-push the arch through the tool.

What You Can Do

Design and build pages

Tell Claude what page you want. It plans the layout, writes Odoo-compatible HTML using paste-ready templates, validates it, and pushes it to your website.

Style with CSS

Claude injects custom CSS through Odoo's custom_code_head — no theme module needed. Describe what you want changed and it writes scoped CSS.

Manage pages

List all pages, fetch HTML for editing, publish or unpublish, create new pages from scratch.

Fix visual issues from screenshots

Share a screenshot and Claude identifies broken elements, writes targeted CSS fixes, and pushes them — all without touching page content.

Create email mailings

Bring your newsletter content as structured markdown. Claude fetches an existing mailing as a template, formats the content into Odoo's email HTML, and pushes it as a draft — ready for you to review and send from Odoo.

Build and deploy surveys

Describe your survey — webinar feedback, NPS, customer research, lead-gen quiz. Claude writes a YAML definition with your questions and answer options, dry-runs it to confirm the payload, then deploys it to Odoo and returns the public share URL. Works with radio buttons, checkboxes, free text, scale ratings, date inputs, and more. Requires the Odoo Surveys app to be installed.

Build a module

Claude scaffolds a complete, installable Odoo module following the standard directory structure — models/, views/, security/, data/, i18n/, and static/. Whether you're building a reusable website snippet or a full business module, the skeleton is production-ready from the first file. Claude follows module_structure.md to know what goes where.

Migrate staging to production

Build on staging, then migrate to production with automatic backup and one-command rollback.

Project Structure

After setup, your project folder looks like this:

my-website/
  .env            # Your Odoo credentials (never shared)
  CLAUDE.md       # Instructions Claude reads every session
  .tmp/           # Temporary working files
  tools/          # Python scripts that talk to Odoo
  workflows/      # Step-by-step guides Claude follows

Tips

• Always dry-run before migrating — the migration tool has a --dry-run flag
• Surveys have a dry-run too — create_survey.py --dry-run prints the full payload before touching Odoo
• Claude reads workflows automatically — ask it to design a page and it reads design_page.md first
• Everything is backed up — before any destructive operation, tools save a backup to .tmp/
• Passwords stay local — only in your .env file, which is never committed

License

MIT — see LICENSE.