| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 731 |
| Technical Name |
sadeem_mcp |
| License | OPL-1 |
| Website | https://sadeem.cloud |
| Versions | 17.0 18.0 19.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 731 |
| Technical Name |
sadeem_mcp |
| License | OPL-1 |
| Website | https://sadeem.cloud |
| Versions | 17.0 18.0 19.0 |
Sadeem MCP â Claude AI Connector
Connect Claude AI to your Odoo instance via the Model Context Protocol (MCP).
Ask Claude questions in plain language and get real Odoo data back â no code required.
Features
Natural Language Queries
Ask Claude in plain language: "Show me overdue invoices" or "Who are my top customers?" and get real data back instantly.
Search Any Model
Use the search_records tool to query any installed Odoo model with custom domain filters â not limited to built-in tools.
Dynamic Tool Discovery
Tools are enabled automatically based on which modules are installed. Accounting tools appear only if accounting is installed, CRM tools only if CRM is installed, etc.
Secure API Key Auth
Uses Odoo's built-in personal API keys. Each user generates their own key and Claude accesses only what that user is permitted to see.
Create Records
Use create_record to create invoices, sales orders, leads, and more â directly from Claude. Records are always created as draft for review before confirmation.
Execute Business Actions
Use execute_action to confirm invoices, close opportunities, validate deliveries, and more â in bulk. Every action is logged in the record's chatter automatically.
Direct Record URLs
Every tool result includes a direct URL to open the record in Odoo. URLs are built using Odoo's own window actions for accurate deep-linking.
How to Connect Claude AI
Step 1 â Install & Enable
- Install the Sadeem MCP module from Apps.
- Go to Settings â Claude AI Connector.
- Toggle Enable MCP Endpoint to ON.
Step 2 â Generate an API Key
- Click Generate API Key in the settings panel.
- Copy the key immediately â it is shown only once.
Step 3 â Add Connector in Claude.ai
- Open claude.ai â Settings â Connectors.
- Click Add custom connector.
- Copy the URL shown in Odoo settings and replace
<YOUR_API_KEY>with your key. - Paste the full URL and save.
Step 4 â Use in Chat
- Start a new chat in Claude.ai.
- Click the + button and enable your Odoo connector.
- Ask anything: "Show me unpaid invoices", "Who are my top 5 customers?", "List open CRM opportunities".
Available Tools
| Tool | Requires Module | Description |
|---|---|---|
search_records | Always | Search any Odoo model with a custom domain filter. Results include a direct URL to each record. |
get_model_fields | Always | List available fields for any model â use before searching or creating records |
create_record | Always | Create a new record in any model (invoice, order, lead, etc.). Always created as draft. Posts a chatter note on creation. |
execute_action | Always | Execute business actions on records: confirm, cancel, validate, mark won/lost, write, and more. Supports bulk operations. Posts chatter note after each action. |
get_record_url | Always | Get the direct Odoo URL for any record by model and ID |
get_overdue_invoices | Accounting | Customer invoices past their due date |
get_upcoming_due | Accounting | Invoices due in the next N days |
get_unpaid_bills | Accounting | Vendor bills that are unpaid |
get_open_orders | Sales | Confirmed sales orders not yet fully invoiced |
get_top_customers | Sales | Top customers ranked by total sales |
get_pending_purchases | Purchase | Purchase orders waiting for approval or delivery |
get_upcoming_vendor_bills | Purchase | Vendor bills due soon |
get_open_leads | CRM | Open CRM leads and opportunities |
get_hot_opportunities | CRM | Opportunities with high probability |
get_low_stock | Inventory | Products below their reorder point |
get_stock_value | Inventory | Stock valuation by product category |
Frequently Asked Questions
Yes. Claude accesses Odoo using your personal API key and respects your user's permissions. Write operations (create_record, execute_action) only succeed if your Odoo user has the required access rights. Records created via Claude are always saved as draft first, giving you full control before any confirmation.
Yes. Custom connectors (MCP) require a Claude Pro or Team plan on claude.ai.
Yes. Each user generates their own API key and connects independently. Each user sees only what their Odoo permissions allow.
Yes â with your permission. create_record creates new records in draft state for your review. execute_action runs business actions (confirm, cancel, validate, etc.) on existing records. Both tools post a note in the record's chatter so every AI-initiated action is traceable. Delete operations are not supported.
Tools are detected by the Odoo technical module name (e.g. account, sale, crm, stock, purchase). Make sure the standard Odoo module is installed, not just a custom extension.
Change Log
Version 1260329002 - 2026-03-29
- New:
create_recordâ create any Odoo record as draft from Claude - New:
execute_actionâ run business actions (confirm, cancel, validate, etc.) in bulk - New:
get_record_urlâ get a direct Odoo URL for any record - All tool results now include a direct
urlfield per record - Chatter notes posted automatically after create and execute actions
- URLs built using Odoo's
ir.actions.act_windowfor accurate deep-linking
Version 260329001 - 2026-03-29
- Initial release
- 13 dynamic tools across Accounting, Sales, Purchase, CRM, Inventory
- Universal search_records and get_model_fields tools
- Native Settings page with API key generation
About
Sadeem is an Egyptian registered company established in 2020 under the name Digital X and then the name was changed to Sadeem in 2023.
Website
https://sadeem.cloud
https://wa.me/201143535115
support@sadeem.cloud
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module