Skip to Content
Getting Started

Claude Code Skill for Odoo, Website Builder Skill

Turn Claude Code into a full Odoo website builder. One command scaffolds everything you need to design, build, and deploy pages on your Odoo site.

Start Setup View on GitHub

What You'll Need

Claude Code

Anthropic's CLI for Claude. Install it from the official docs before you begin.

Python 3.8+

Check your version with python3 --version in your terminal.

Odoo Credentials

Your Odoo URL, database name, login email, and password.

Setup

1

Clone the Repo

View on GitHub

Ask Claude to add this Skill to your setup aka clone the repository and copy the skills into your Claude Code skills directory:

git clone https://github.com/19prince/claude-odoo-builder.git cp -r claude-odoo-builder/skills/* ~/.claude/skills/

This installs two skills:

  • new-odoo-project — scaffolds a complete Odoo website builder project with tools and workflows
  • odoo-theme-fix — reviews page screenshots and pushes CSS fixes via RPC
2

Install Python Dependencies

Ask Claude or open your terminal and run:

pip install requests python-dotenv

That's it — just two packages.

3

Run the Skill

Open Claude Code in your terminal and type:

/new-odoo-project

Claude will ask you a few questions:

  • Where should the project live?
  • Client or project name
  • Your Odoo URL
  • Database name
  • Login email
  • Staging or production?
4

Add Your Password

Claude creates a .env file but leaves the password blank. Open it and fill it in:

nano ~/projects/my-website/.env

Add your password on the ODOO_PASSWORD= line:

ODOO_PASSWORD=your-password-here
Security note: Claude never asks for or stores your password. It stays in your local .env file and is never committed to git.

Verify & Configure

5

Verify the Connection

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

Troubleshooting:
  • Authentication error — double-check your password in .env
  • Connection error — double-check your Odoo URL and database name
6

Check the Website Editor

Open your Odoo website editor in a browser to verify everything works:

  1. Log into your Odoo backend
  2. Go to Website and click Edit on any page
  3. Check the Blocks panel - thumbnails should load without warning icons
  4. Try dragging a block onto the page

If you see orange warning icons on the blocks, tell Claude - there's a quick fix for that.

7

Set Your Brand

Claude will ask about your brand identity:

  • Colors:  primary, secondary, background (or say "TBD")
  • Fonts: your brand fonts (or "TBD")
  • Design direction:  dark, light, minimal, bold (or "TBD")
  • Logo: whether you have a file or use text

Everything can be updated later, so don't worry if you're not ready.

The Fine Print

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 You Can Build

Design Pages

Tell Claude what page you want. It plans the layout, writes the HTML, validates it, and pushes it live.

Style with CSS

Inject custom CSS through Odoo's system - no theme module needed. Just describe what you want changed.

Manage Pages

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

Migrate to Prod

Build on staging first. When ready, Claude migrates with automatic backup and one-command rollback.

Tips

Dry-Run First

Always use the --dry-run flag before migrating. It previews changes without touching your live site.

Auto-Workflows

Claude reads workflows automatically. Ask it to design a page and it reads the right guide. You don't need to tell it.

Everything Backed Up

Before any destructive operation, the tools save a backup to .tmp/ with a rollback command included.

Get Started Today

Ready to Build?

Install the skill and start designing your Odoo website in minutes.