Skip to content
MCP server

odoo-lint

Rust-based Odoo addon linter with OCA rule parity, exposed to AI agents over MCP

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Linux, macOS
Runs
Locally
Version
0.1.0-alpha.21
Listing updated
3 days ago

About odoo-lint

odoo-lint is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

odoo-lint ships a command called odl, and its MCP server (odl mcp) lets a coding agent lint Odoo modules as it edits them. The checks cover Python files, manifests, XML and CSV data, translation .po files and OWL JavaScript templates, reusing the codes, names and messages of OCA's pylint-odoo, oca-checks-odoo-module and oca-checks-po so existing pylint disable comments keep working.

Beyond parity, it flags files that should not be in a module, such as packages or database dumps committed by accident, and has a family of upgrade rules for leftovers from older Odoo versions. Translation checks try to predict why Odoo's loader logs a malformed po file or why a translation never shows up. Safe and unsafe automatic fixes work on Python, manifests, XML and .po files, with a diff preview.

The README claims it is far faster than pylint with pylint-odoo on an OCA repository, which is its main pitch for pre-commit and CI use. Plugins for Claude Code, DeepSeek Harness and OpenCode run the linter after every file the agent edits. It is MIT licensed.

Install

Run in a terminal

claude mcp add odoo-lint -- uvx odoo-linter

Add to claude_desktop_config.json

{
  "mcpServers": {
    "odoo-lint": {
      "command": "uvx",
      "args": [
        "odoo-linter"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "odoo-lint": {
      "command": "uvx",
      "args": [
        "odoo-linter"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "odoo-lint": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "odoo-linter"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "odoo-lint": {
      "command": "uvx",
      "args": [
        "odoo-linter"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "odoo-lint": {
      "command": "uvx",
      "args": [
        "odoo-linter"
      ]
    }
  }
}

What it does

OCA check parity
Reuses pylint-odoo and OCA rule codes, names and messages.
Automatic fixes
Applies safe and unsafe fixes to Python, manifests, XML and .po files, with a diff preview.
Upgrade rules
Flags code left over from older Odoo versions, such as old Bootstrap 4 classes.
Translation checks
Explains malformed .po files and translations that fail to load.
CI output formats
Emits GitHub annotations, GitLab Code Quality, SARIF and JSON.
Agent integration
MCP server plus post-edit plugins for Claude Code, DeepSeek Harness and OpenCode.

Good for

  • Lint every file an AI agent edits in an Odoo addon
  • Replace slow pylint-odoo runs in pre-commit or CI
  • Migrate a module to a newer Odoo version with upgrade hints
  • Find why a translation does not appear in Odoo
  • Catch SQL injection and deprecated name_get usage early

Pricing

Open source

MIT licence; free to install with pip, uv, pipx or cargo.

Prices change. Check odoo-lint.readthedocs.io before you buy.

odoo-lint FAQ

How do I install it?

The PyPI package is called odoo-linter (uv tool install odoo-linter or pipx), and the crates.io package is odoo-lint. The command is odl.

Can it replace pylint-odoo?

The README describes it as a drop-in with matching codes and messages, and says each check matches OCA's own test suites.

What licence is it?

MIT.

Where is it configured?

In pyproject.toml, including company-specific author rules.

Is odoo-lint free?

Yes. odoo-lint is open source, so you can use and self-host it for free.

How do I add odoo-lint to Claude Code?

Run this command in your terminal: claude mcp add odoo-lint -- uvx odoo-linter

What are the best alternatives to odoo-lint?

The closest alternatives to odoo-lint are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to odoo-lint

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools