MitDesk docs
Getting started

Installing MitDesk

4 min read Odoo 20.0

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 minddesk needs only modules that come with Odoo Community: base, base_automation, html_editor, mail and web.
  • 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

  1. Open Apps.
  2. Search for MitDesk.
  3. Click Install.

Only the core module is an application. The other modules are not apps, so remove the default Apps filter to see them.

The Apps list filtered on MitDesk, showing one application tile

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_threads must be at least 1. MitDesk recommends 4.
  • limit_time_real_cron is 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