# odoo-lint

> odoo-lint is an open-source MCP server for developer tools. Rust-based Odoo addon linter with OCA rule parity, exposed to AI agents over MCP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Website:** https://odoo-lint.readthedocs.io/en/latest/ai.html
- **Repository:** https://github.com/getfluvo/odoo-lint
- **MCP Registry name:** io.github.GetFluvo/odoo-lint
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/odoo-lint
