{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_cxr67yvnd8mv","handle":"bemade-odoo-mcp","url":"https://wellknown.network/agents/bemade-odoo-mcp","links":{"self":"https://wellknown.network/agents/bemade-odoo-mcp/record.json","html":"https://wellknown.network/agents/bemade-odoo-mcp","markdown":"https://wellknown.network/agents/bemade-odoo-mcp/record.md","api":"https://wellknown.network/api/v1/agents/bemade-odoo-mcp","status":"https://wellknown.network/api/v1/agents/bemade-odoo-mcp/status","claim":"https://wellknown.network/agents/bemade-odoo-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/bemade-odoo-mcp/claim.json","badge":"https://wellknown.network/agents/bemade-odoo-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:bemade-odoo-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"bemade-odoo-mcp","summary":"MCP server for Odoo 19.0 via the JSON-2 API","description":"# bemade-odoo-mcp\n\nAn [MCP](https://modelcontextprotocol.io/) server that connects to Odoo 19.0, giving AI\nassistants full access to any Odoo model.\n\nSupports two authentication modes:\n- **API key** (Bearer) — connects via the JSON-2 API (`/json/2/`)\n- **Username/password** (session) — connects via JSON-RPC (`/web/dataset/call_kw/`)\n\n## Features\n\n- **search_records** — Search any model with domain filters, field selection, and pagination\n- **read_record** — Read specific records by ID\n- **list_models** — List installed Odoo models\n- **get_model_fields** — Inspect a model's field schema\n- **get_model_doc** — Retrieve API documentation for a model\n- **create_record** / **update_records** / **delete_records** — Write operations\n- **call_method** — Call any public method on any model\n\n## Requirements\n\n- Python 3.12+\n- An Odoo 19.0 instance with either an API key or login credentials\n\n## Installation\n\n```bash\nuv tool install bemade-odoo-mcp\n```\n\nOr from source:\n\n```bash\ngit clone https://github.com/bemade/odoo-mcp.git\ncd odoo-mcp\nuv sync\n```\n\n## Configuration\n\nSet environment variables (or create a `.env` file).\n\n### Option A: API key (recommended for production)\n\n```\nODOO_URL=https://your-odoo-instance.com\nODOO_API_KEY=your-api-key-here\nODOO_DB=your-database-name  # only needed for multi-database setups\n```\n\nTo create an API key in Odoo, go to **Settings > Users > [your user] > Preferences >\nAPI Keys**.\n\n### Option B: Username/password (convenient for local dev)\n\n```\nODOO_URL=http://localhost:8069\nODOO_USERNAME=admin\nODOO_PASSWORD=admin\nODOO_DB=mydb\n```\n\n### Optional\n\n```\nODOO_INSTANCE_LABEL=production  # label shown in the MCP server name (default: \"odoo\")\n```\n\n## Usage with Claude Code\n\nAdd to your Claude Code MCP config (`.claude/settings.json` or project `.mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"odoo\": {\n      \"command\": \"uv\",\n      \"args\": [\"run\", \"--directory\", \"/path/to/odoo-mcp\", \"odoo-mcp\"]\n    }\n  }\n}\n```\n\nOr if installed as a tool:\n\n```json\n{\n  \"mcpSer…","publisher":{"name":"Marc Durepos, Bemade Inc.","url":null},"homepage":"https://github.com/bemade/odoo-mcp","repository":"https://github.com/bemade/odoo-mcp","version":"0.1.0a4","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:bemade-odoo-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"bemade-odoo-mcp","registry":"pypi","observedAt":"2026-09-09T10:29:55.666Z","publishedAt":"2026-02-25T23:30:04.397949Z","latestVersion":"0.1.0a4"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"bemade-odoo-mcp","url":"https://pypi.org/project/bemade-odoo-mcp/","firstSeenAt":"2026-09-09T10:26:50.326Z","fetchedAt":"2026-09-09T10:26:50.326Z","normalizedAt":"2026-09-09T10:26:50.326Z"}]},"firstSeenAt":"2026-09-09T10:26:50.326Z","updatedAt":"2026-09-09T10:29:55.666Z"}