📃 MailDesk Documentation
Anmelden
📃

MailDesk Documentation

Welcome to the MailDesk Documentation — the official guide to setting up and using MailDesk inside Odoo.

MailDesk is a professional email client that allows you to manage Gmail, Outlook / Microsoft 365, and IMAP mailboxes directly in Odoo.

This documentation helps you get started quickly and use MailDesk efficiently in your daily work.


New to MailDesk?

If you are using MailDesk for the first time, start here:
Start here

  • What MailDesk is and how it works

  • How email syncing behaves

  • Your first steps after installation

You’ll be productive in 10–15 minutes.


Connect your email account

MailDesk supports multiple email providers. Choose your setup guide:
Connect your email account

  • Gmail (OAuth 2.0 + Gmail API)

  • Outlook / Microsoft 365 (OAuth 2.0 + Microsoft Graph)

  • IMAP (any other email provider)

Each guide explains the full process step by step and what to expect after syncing.


Daily use

Once your mailbox is connected, learn how to work efficiently every day:
Daily use

  • Read and reply to emails

  • Compose and send messages

  • Organize emails with folders and tags

  • Search and filter your mailbox


Troubleshooting

If something doesn’t work as expected, check this section first:
Troubleshooting

  • Emails are missing or delayed

  • Sync issues with Gmail, Outlook, or IMAP

  • OAuth authorization problems

  • Sent emails not appearing

Most issues can be solved quickly without technical intervention.


Security & privacy

MailDesk is built with security and privacy in mind:
Security & privacy

  • What MailDesk stores (and what it doesn’t)

  • OAuth vs passwords

  • How to revoke access

  • Security best practices for production systems


Recommended reading order

For the best experience, follow this order:

Start here → Introduction
Start here → Getting started with MailDesk
Connect your email account (choose your provider)
Daily use
Troubleshooting (if needed)


Shared Mailboxes & Teamwork

MailDesk is designed for collaboration. You can share a single mailbox (e.g., [email protected]) with multiple users.

Key Concepts:

  • Owner: Every account has a mandatory Owner. This is typically the user who connected the account.
  • Is Shared: If this flag is enabled, it indicates the mailbox is intended for team use.
  • Users with Access: You can explicitly list Odoo users who are allowed to see and manage this mailbox.

Permissions & Roles

Access to MailDesk functions is controlled by two main security groups:

  • Mailbox User: Can connect personal accounts and work with shared mailboxes they are granted access to.
  • Mailbox Admin: Can manage any account, view all mailboxes, and perform maintenance tasks like Reset Sync State.

⚠️ Administrators automatically have access to all mailboxes, regardless of the Users with Access list.

Need more help?

If you can’t find an answer here:

  • Check Troubleshooting

  • Contact your Odoo administrator (OAuth, server, permissions)

  • Use your Help Center to reach support

Tip:

Start with one mailbox, verify that sending and receiving works, and then add more accounts step by step.