Installing MitDesk
This page helps you install MitDesk, choose the modules you need, and set up your server so the assistant can answer.
Who this is for: the Odoo administrator who installs apps.
You need: Edition: the install steps apply to every edition. Which modules you get depends on your edition. See Editions.
Before you start
- The core module
minddeskneeds only modules that come with Odoo Community:base,base_automation,html_editor,mailandweb. - You do not need extra Python packages. The AI provider libraries load only when you use that provider. If one is missing, MitDesk names the package. Install it into the Python that runs Odoo, then restart the server.
- Your Odoo server must run background workers for the assistant. See Check your server.
Install the core module first
- Open Apps.
- Search for MitDesk.
- Click Install.
Only the core module is an application. The other modules are not apps, so remove the default Apps filter to see them.
What you should see: after the install, the MitDesk menu appears for everyone in the group MitDesk User.
Install minddesk before any other MitDesk module. All other modules depend on it. Most of them also check the version of the core module when you install them. If the core is too old, the install stops and tells you which version it needs.
Choose your modules
Modules are grouped by edition. Editions add to each other: Pro includes Basic, and Business includes Pro. Ultimate has no extra module. The full explanation is in Editions.
Basic
| Module | What it adds |
|---|---|
minddesk |
Chat, agents, AI models and endpoints, tools, skills, approvals, jobs, the audit log, the cockpit and the 360 board |
Pro
| Module | What it adds | Needs |
|---|---|---|
minddesk_pro |
Knowledge sources and search | MitDesk |
minddesk_dashboard |
Dashboards | MitDesk |
minddesk_flow |
Automations | MitDesk, base_automation |
minddesk_account |
Accounting tools | Odoo account |
minddesk_sale |
Sales tools | Odoo sale_management |
minddesk_crm |
CRM tools | Odoo crm |
minddesk_purchase |
Purchase tools | Odoo purchase |
minddesk_stock |
Inventory tools | Odoo stock |
minddesk_project |
Project tools | Odoo project |
Business
| Module | What it adds | Needs |
|---|---|---|
minddesk_workforce |
Digital employees | MitDesk, mail, resource |
minddesk_sovereign |
Routing rules for where data may go | minddesk_workforce |
minddesk_compliance |
The audit hash chain and compliance records | MitDesk |
minddesk_mcp |
The MCP server for outside AI tools | MitDesk |
minddesk_mcp_document |
Document intelligence | minddesk_mcp, minddesk_pro, account, sale_management, purchase |
minddesk_mcp_ai |
Joins the MCP server to Odoo's own AI client. Odoo 20 only. | minddesk_mcp, Odoo ai_mcp (Enterprise) |
minddesk_hr |
HR tools | Odoo hr, hr_holidays |
minddesk_helpdesk |
Helpdesk tools | Odoo helpdesk (Enterprise) |
minddesk_voip |
Telephony tools | Odoo voip (Enterprise) |
minddesk_maildesk |
Mail tools | The MailDesk mail client module. Linking mail to records needs MailDesk Pro. |
Each bridge module links MitDesk to one Odoo app. Install a bridge only if you use that app. See Domain bridges.
Some bridges need Odoo Enterprise
The Helpdesk and Telephony bridges need the Odoo apps Helpdesk and VoIP. Odoo ships these only in Enterprise. On Odoo Community you cannot install these two bridges. The Odoo AI integration (minddesk_mcp_ai) also needs an Enterprise module.
Check your server
The assistant runs each answer as a background job on Odoo's cron workers. If no worker runs these jobs, messages are accepted but never answered.
Set these two values in odoo.conf:
max_cron_threads = 4
limit_time_real_cron = 900
max_cron_threadsmust be at least 1. MitDesk recommends 4.limit_time_real_cronis how many seconds Odoo lets a cron worker run before it stops it. An agent may work for up to 600 seconds, and the worker needs extra time to start and to save the result. 900 covers that. For agents that work longer, use a higher value, but not more than 1800. Lower the agent's time limit instead.
To check, open Settings and find the MitDesk section, then the block Turn worker.
- A green line "the turn worker ran within the last five minutes" means all is well.
- A red box "Nothing is running agent turns" means no worker has run recently or no cron thread is set. The box says what to fix.
- A yellow box "This server ends long turns early" names the agents whose time limit is higher than your server allows.
You can open Settings from MitDesk ▸ Configuration ▸ Settings. Only a MitDesk Administrator sees the MitDesk section.
After you install
The MitDesk menu appears for everyone in the group MitDesk User. Other menus depend on the user's group:
- Governance is for approvers.
- Configuration is for administrators. Under Engine you find AI Models and AI endpoints.
See Permissions and groups for who sees what.
The cockpit shows a Getting started strip with four steps: choose a provider, connect and test it, confirm the default agent, and start the first chat.
Nothing answers yet. You must connect a model first.
If it does not work
If a module will not install, update minddesk first and try again. If nothing answers after the install, connect a model. See Troubleshooting.
Next steps
- Connecting a model
- Permissions and groups. Read this before you add colleagues.
- Your first conversation
- The modules
- Troubleshooting