Metadata-Version: 2.4
Name: bemade-odoo-mcp
Version: 0.1.0a2
Summary: MCP server for Odoo 19.0 via the JSON-2 API
Author: Marc Durepos, Bemade Inc.
Author-email: Marc Durepos, Bemade Inc. <marc@bemade.org>
License-Expression: LGPL-3.0-only
Classifier: Development Status :: 2 - Pre-Alpha
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp[cli]>=1.26.0
Requires-Python: >=3.12
Project-URL: Homepage, https://github.com/bemade/odoo-mcp
Project-URL: Repository, https://github.com/bemade/odoo-mcp
Project-URL: Issues, https://github.com/bemade/odoo-mcp/issues
Description-Content-Type: text/markdown

# bemade-odoo-mcp

An [MCP](https://modelcontextprotocol.io/) server that connects to Odoo 19.0 via the
JSON-2 API (`/json/2/`), giving AI assistants read access to any Odoo model.

## Features

- **search_records** — Search any model with domain filters, field selection, and pagination
- **read_record** — Read specific records by ID
- **list_models** — List installed Odoo models
- **get_model_fields** — Inspect a model's field schema

## Requirements

- Python 3.12+
- An Odoo 19.0 instance with an API key

## Installation

```bash
uv tool install bemade-odoo-mcp
```

Or from source:

```bash
git clone https://github.com/bemade/odoo-mcp.git
cd odoo-mcp
uv sync
```

## Configuration

Set environment variables (or create a `.env` file):

```
ODOO_URL=https://your-odoo-instance.com
ODOO_API_KEY=your-api-key-here
ODOO_DB=your-database-name  # only needed for multi-database setups
```

To create an API key in Odoo, go to **Settings > Users > [your user] > Preferences >
API Keys**.

## Usage with Claude Code

Add to your Claude Code MCP config (`.claude/settings.json`):

```json
{
  "mcpServers": {
    "odoo": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/odoo-mcp", "odoo-mcp"]
    }
  }
}
```

Or if installed as a tool:

```json
{
  "mcpServers": {
    "odoo": {
      "command": "odoo-mcp"
    }
  }
}
```

## Development

```bash
uv sync
uv run pytest
```

## License

LGPL-3.0-only
