odoo-lint
Rust-based Odoo addon linter with OCA rule parity, exposed to AI agents over MCP
- 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-linterAdd to claude_desktop_config.json
{
"mcpServers": {
"odoo-lint": {
"command": "uvx",
"args": [
"odoo-linter"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"odoo-lint": {
"command": "uvx",
"args": [
"odoo-linter"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools