MailDesk docs
Get MailDesk
Technical

Module reference

The MailDesk suite for Odoo is 11 modules, each maintained as its own git repository under products/maildesk/18/<repo>/<module>/. Dependency shape: Basic ← Pro ← {9 integration bridges}. Every bridge requires Pro; the Cockpit additionally requires Automation and Odoo's resource.

2 min read

The MailDesk suite for Odoo is 11 modules, each maintained as its own git repository under products/maildesk/18/<repo>/<module>/. Dependency shape: Basic ← Pro ← {9 integration bridges}. Every bridge requires Pro; the Cockpit additionally requires Automation and Odoo's resource.

Versions below are the v18 line at the time of writing. The suite also ships for Odoo 17 and 19 with equivalent behavior.

Inventory

Module (technical) Display name Version Depends on (key) App
maildesk_mail_client Email Client & Unified Inbox — Basic 18.0.4.1.3 web, contacts, mail, microsoft_outlook, google_gmail ✓
maildesk_mail_client_pro MailDesk Pro — Two-Way Sync + AI 18.0.4.1.0 Basic, mail, web ✓
maildesk_mail_client_automation Automation Engine 18.0.1.1.0 Basic, Pro, mail —
maildesk_mail_client_calendar Calendar Integration 18.0.1.1.0 Basic, Pro, calendar, mail —
maildesk_mail_client_chatter Chatter Integration 18.0.1.2.0 Basic, Pro, mail —
maildesk_mail_client_cockpit Cockpit 18.0.1.2.0 Basic, Pro, Automation, resource —
maildesk_mail_client_crm CRM Integration 18.0.1.2.0 Basic, Pro, crm, mail —
maildesk_mail_client_documents Documents Integration 18.0.1.2.0 Basic, Pro, documents, mail —
maildesk_mail_client_helpdesk Helpdesk Integration 18.0.1.1.0 Basic, Pro, helpdesk, mail —
maildesk_mail_client_partner360 Partner 360 18.0.1.2.0 Basic, Pro —
maildesk_mail_client_sale Sales Integration 18.0.1.2.0 Basic, Pro, sale, mail —

Install order

Odoo resolves dependencies automatically, but conceptually: install Basic first (it pulls in google_gmail and microsoft_outlook), then Pro, then any integration bridges you need. Installing a bridge will pull in Basic and Pro automatically. See Installation.

Role of each module

  • Basic (maildesk_mail_client) — the engine. Owns the single source of truth for messages (maildesk.message_index), the body/metadata cache (maildesk.ui_cache), folders, drafts, email state, the composer, and the scheduled background sync (Gmail/Outlook/IMAP). Inbound (one-way) sync. Two groups: Mailbox User and Mailbox Admin. No AI; non-adaptive desktop UI.
  • Pro (maildesk_mail_client_pro) — extends Basic with two-way sync (flags/moves/deletes pushed back to the provider via an outbound mutation queue), AI (multi-provider), the mobile-adaptive UI, realtime sync (4.2.0), signatures, and the per-mailbox allow_ai control and access_user_ids controls. Required by every bridge.
  • Automation — typed rules (triggers, conditions, actions) with an audit log and idempotency.
  • Calendar — link meetings/invitations between MailDesk threads and Odoo Calendar.
  • Chatter — surface MailDesk email threads inside a record's chatter (lazy, write-back only).
  • Cockpit — read-side manager view: KPIs, AI briefings (per-tier quotas), SLA, 4-tier permissions.
  • CRM / Sales / Helpdesk / Documents — link emails to leads / quotations & orders / tickets / documents (single-source-of-truth-safe linking).
  • Partner 360 — read-only embedded customer-intelligence panel.

At a glance (Basic engine, verified counts)

Aspect Basic Pro (adds)
Models ~30 (incl. mailbox.account, mailbox.folder, maildesk.message_index, maildesk.ui_cache, maildesk.ingest_queue, maildesk.draft, maildesk.email_state) AI models (maildesk.ai.*), maildesk.update_queue, maildesk.email.link, signatures, (4.2.0) prefetch + push subscription
Background jobs 9 scheduled jobs (sync, ingest, bootstrap, backfill, cache cleanup) update-queue process + cleanup; (4.2.0) prefetch warm, IMAP profile probe, push renewal
Controllers /maildesk, Outlook OAuth authorize + callback "Ask AI" overrides; (4.2.0) Gmail/Outlook push webhooks
Groups Mailbox User, Mailbox Admin per-mailbox allow_ai, access_user_ids
Frontend 16 OWL components + 4 services + 2 hooks mobile services/hooks/components, AI panel, dark theme

For models, controllers, security, frontend, sync, AI, and realtime details, see the rest of the Technical section. For the original architecture/refactor analysis (ADRs, contracts, findings) see the developer-only internal/architecture/ set.

Verified against each module's __manifest__.py and source tree (v18). Re-confirm versions before publishing — they advance with releases.