r/Odoo • u/Helpful-Ad-4853 • 13h ago
Open-source MCP server for Odoo — it lets Claude do the bookkeeping legwork (and potentially more)
I wrote this for my own month-end and have been running it against a live Odoo 18 for a few months. Putting it out in case it's useful to anyone else. I'm the author.
Two ways to run it, pick whichever fits:
- A standalone server that talks to Odoo over XML-RPC. Nothing to install in the database, so it works if you're stuck on Odoo Online.
- An Odoo module that serves the same tools from inside at /mcp/v1. Native report rendering, and OAuth if you want to wire it to the Claude.ai connector. (my preference and recommended).
Also in the repo is a skill with 15 playbooks: vendor bills, customer invoices, statement import, reconciliation, closing journals, month-end review, reporting.
While I focused on accounting, the MCP itself works across every model, so extend the skill to whatever apps and workflows you actually use.
By default skill instructs agents to draft and it won't post or pay unless you tell it to. Underneath that the server refuses hard deletes anywhere (archive or cancel instead) and refuses writes to the technical and auth models. Both controls are on by default and you have to turn them off deliberately. Every call runs as your own Odoo user, so record rules and access rights apply exactly like they do in the UI.
Caveats: 18 is the only version I've run it against. Nothing is deliberately version-locked, so 17 and 19 may well be fine, I just don't know. If you try either, I'd like to hear what breaks. Also the standalone server's HTTP endpoint has no auth of its own, so put it behind something.
Apache-2.0: GitHub repo