MitDesk — Mail
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.
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. |
Link mail to records
| 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.
Related
- Domain bridges: all bridges side by side.
- How consent works: when an action runs, asks or is refused.
- The modules: every module and what it needs.