MitDesk docs
Modules

MitDesk — Mail

4 min read Odoo 20.0

Read mail, write drafts and tidy mailboxes through MailDesk. The AI cannot send or delete mail.

Technical name minddesk_maildesk.

Edition: Business and above. See Editions and how the modules fit together.

This bridge connects MitDesk to MailDesk. It adds a fixed set of named tools. It is not a way to call any method on any model. Every call runs as the person who asks.

Cockpit business areas, including MailDesk

Odoo app it needs: MailDesk (maildesk_mail_client).

Tools

MitDesk Mail has 36 tools. Reading is free. Anything that changes something asks a person first, unless an autonomy rule you wrote allows it.

Read mail

Tool What happens What it does
maildesk_mailbox_list Reads List your mailboxes with their connection health.
maildesk_folder_tree Reads Folders of one mailbox, with unread counts.
maildesk_message_search Reads Search the message index.
maildesk_message_read Reads Open one message.
maildesk_thread_read Reads Read a whole conversation thread.
maildesk_unread_counts Reads Unread counts per folder.
maildesk_tag_list Reads List mail tags.

Contacts and files

Tool What happens What it does
maildesk_contact_find Reads Find a contact by name or email address.
maildesk_partner_mail_feed Reads Mail history with one contact across the mailboxes you can see.
maildesk_attachment_list Reads Name, type and size of the files on one email.
maildesk_attachment_open Asks first by default Read one attachment as text. You never get the file or a download link.
maildesk_attachment_file_to_documents Asks first by default File one attachment into Odoo Documents.
Tool What happens What it does
maildesk_record_links_read Reads Which records an email is linked to.
maildesk_record_mail_read Reads The emails linked to one record.
maildesk_record_link_create Always asks first Link one email to one record.
maildesk_record_link_remove Always asks first Remove a link. The email itself is not touched.

Change mail inside Odoo

Tool What happens What it does
maildesk_message_set_flags Asks first by default Mark read or unread, star or unstar.
maildesk_message_tag_apply Asks first by default Add or remove tags on one email.
maildesk_tag_create Always asks first Create a tag. Every MailDesk user sees it.
maildesk_message_move Asks first by default Move one email to another folder of the same mailbox. Moving to trash is not deleting.

Drafts

Tool What happens What it does
maildesk_draft_prepare Reads Work out recipients and quoted text for a reply, reply all or forward.
maildesk_draft_compose Asks first by default Write or change a draft. A person opens it and sends it.
maildesk_draft_read Reads Read a draft back.
maildesk_draft_delete Always asks first Delete one draft.

Mailbox health

Tool What happens What it does
maildesk_mailbox_setup_status Reads What a mailbox still needs before it works.
maildesk_mailbox_diagnose Reads Why a mailbox is not working.
maildesk_mailbox_request_sync Asks first by default Queue a fetch of new mail.
maildesk_mailbox_retry_failed_folders Asks first by default Restart a stalled folder or reopen a dead letter.

Automation rules

Tool What happens What it does
maildesk_automation_list Reads A mailbox's rules and its master switches.
maildesk_automation_dry_run Reads Test the rules on one real email without doing anything.
maildesk_automation_history Reads What the rules did.
maildesk_automation_template_list Reads Ready-made rule templates.
maildesk_automation_create Always asks first Create a rule, switched off.
maildesk_automation_update Always asks first Change a rule's filters.
maildesk_automation_set_active Always asks first Switch a rule on or off.
maildesk_automation_template_apply Asks first by default Create a rule from a template, switched off.

Limits that always apply

  • Mailbox membership is the key. Every tool checks that you are a member of the mailbox, also for a mailbox administrator.
  • Mail is untrusted text. Subjects, bodies, senders and file names reach the model marked as data. An instruction inside a mail is not followed.
  • No sending, no deleting. The bridge has no tool to send or delete mail. Drafts are written for a person to open and send.
  • Only a person can: trust a sender, change the remote-image and tracking-pixel setting, create or delete a mailbox, join a shared mailbox, change who may use a mailbox, read or set passwords and tokens, reset a mailbox, create a folder, delete a rule, or run a rule that answers or forwards mail.
  • Rules can be built, not fired. A new rule starts switched off. Rules that reply or forward are refused. Use the dry run before you switch a rule on.

What to know

  • MailDesk Pro. Linking mail to records needs MailDesk Pro. Without it the link tools say this is an edition limit, not an empty result.
  • Moves and flags may stay in Odoo. Without the MailDesk Pro execution add-on, a move or flag is recorded in Odoo but the mail server is not told. The next sync can undo it. Each result says whether the server was told.
  • Licence. If MailDesk is installed but its licence is not active, the tools say so. That is not an empty inbox.

On the 360 board

Card: Mail (on the 360 board, matched by email address) and a MailDesk area in the Cockpit.

Requirements

Needs minddesk, maildesk_mail_client.