odoo-documentation-mcp

MCP server for Odoo documentation — provides versioned context from odoo.com documentation. Search, browse, and retrieve Odoo documentation pages for versions 13.0 through 19.0.

Tools

| Tool | Description | |------|-------------| | search_docs | Search Odoo docs for a specific version | | get_doc_page | Get full content of a documentation page | | get_doc_toc | Get table of contents for a doc section | | list_versions | List supported Odoo versions |

Installation

npm (global)

npm install -g odoo-documentation-mcp

npx (no install)

npx odoo-documentation-mcp

Smithery

npx @smithery/cli install odoo-documentation-mcp --client claude

Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "odoo-docs": {
      "command": "npx",
      "args": ["-y", "odoo-documentation-mcp"],
      "env": {
        "GITHUB_TOKEN": "your-github-token"
      }
    }
  }
}

Cursor / Windsurf / Other MCP clients

{
  "mcpServers": {
    "odoo-docs": {
      "command": "npx",
      "args": ["-y", "odoo-documentation-mcp"],
      "env": {
        "GITHUB_TOKEN": "your-github-token"
      }
    }
  }
}

Environment variables

| Variable | Required | Description | |----------|----------|-------------| | GITHUB_TOKEN | No | GitHub personal access token for higher API rate limits. Without it, falls back to web scraping. |

Supported versions

Odoo 13.0, 14.0, 15.0, 16.0, 17.0, 18.0, 19.0

Development

# Clone and install
git clone https://github.com/dalvarezperez/odoo-documentation-mcp
cd odoo-documentation-mcp
npm install

# Build
npm run build

# Run
npm start
# or: npm run dev (build + run)

License

MIT