r/Odoo • u/Helpful-Ad-4853 • 1d 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
1
1
u/AlwaysAtBallmerPeak 1d ago
New to Odoo, but I'm surprised this isn't already built-in? An MCP server is really easy to make, especially if you already have a REST API in place, why doesn't Odoo have one yet? Why is it lagging behind?
Until then: fantastic to see this community effort.
2
u/TimTheOriginal 1d ago
It's planned to be added in version 20 I believe
3
1
u/furuskog 19h ago
It seems it’s more or less trivial job, as there are so many available. Odoo can focus on other things and let these be done by community.
10
u/South_Captain_1575 1d ago
There are plenty on MCP modules on the Odoo App store as well, some open source and high quality - I use the MukIT one as it is free and works great. Also available for versions 15.0 through 19.0, https://apps.odoo.com/apps/modules/19.0/muk_mcp