Your inbox, inside Odoo
Mail Client Pro is a full IMAP/SMTP email client built into Odoo — a Thunderbird-style three-pane view. Read, write and reply to your mail, and link any message to a contact, CRM lead, sales order or task with one click. Your messages stay on your own server; Odoo never deletes a thing.
Request a quote → See features// THREE-PANE LAYOUT
Everything you expect from a mail client — wired into Odoo
A real desktop-grade mailbox experience, with the one thing a standalone client can never give you: a direct line to your CRM, Sales and Project records.
Three-pane layout
Accounts and folders on the left, the message list on top, the body below. Drag the dividers to resize the panes and fit your screen.
Link to Odoo
Attach any email to a contact, CRM lead, sales order, task or helpdesk ticket. The message lands in the record's chatter — the whole conversation in one place.
Passive mode
Nothing is read or deleted on the server without your action. The client uses BODY.PEEK and never flips the read flag silently — your mailbox stays exactly as you left it.
OAuth2 & app passwords
Sign in to Gmail with OAuth2 — no password ever stored. For any other provider use an app password, encrypted with Fernet in the database.
Full composer
Compose, reply and forward with the original quoted. Send over SMTP, drop a copy in your Sent folder, and add your own HTML signature.
Body on-demand
Odoo caches only the headers it needs for the list. Full message content is fetched the moment you open it — light on storage, fast to browse.
A personal mailbox client — not a mail server replacement
Mail Client Pro sits next to Odoo's built-in mail, not on top of it. Here is exactly where it fits.
✓ What it is
- A private mailbox client for each Odoo user
- A bridge between your inbox and CRM / Sales / Project records
- IMAP/SMTP with OAuth2 (Gmail) or app password (generic)
- Passive: your mail stays on your server, untouched
- Encrypted secrets, strict per-user isolation
— What it is not
- Not a replacement for Odoo's fetchmail / incoming gateway
- Not a replacement for Discuss — chatter and internal messages stay
- Not a background scraper — no silent fetching or deleting
- Not a shared mailbox — accounts are private per user
- Not a marketing or mass-mailing platform
From install to first email in minutes
Add an account, test it, sync your folders, start reading. No background jobs to babysit.
Add an account
Mail Client → Configuration → My accounts → New. Set a name, email and provider (Gmail OAuth or generic IMAP).
under a minuteTest connection
Click Test connection. For Gmail you authorize via OAuth; for generic IMAP you enter your app password.
instantSync folders
Click Sync folders to pull the folder list straight from your mailbox into Odoo.
secondsRead & link
Open the inbox, read in the three-pane view, and link any message to an Odoo record.
🚀 doneBuilt on standards, secured by design
No proprietary mail protocol, no shady background magic. Just IMAP/SMTP, encrypted secrets and Odoo's own permission model.
- ▸ IMAP over SSL/TLS (993)
- ▸ SMTP STARTTLS (587)
- ▸ OAuth2 for Gmail
- ▸ App password (generic)
- ▸ imapclient wrapper
- ▸ Fernet (AES-128 + HMAC)
- ▸ Per-user record rules
- ▸ BODY.PEEK (no silent read)
- ▸ Key in ir.config_parameter
- ▸ Secrets backed up with DB
- ▸ Odoo 19 (Community/Ent.)
- ▸ Depends: base, mail, web
- ▸ message_post to chatter
- ▸ Coexists with Discuss
- ▸ OPL-1 license
Questions, answered
Does it delete or modify my emails?
No. Mail Client Pro runs in passive mode. Messages stay on your IMAP server and Odoo keeps only a header cache. It never deletes a message or marks it as read without your action — it reads with BODY.PEEK.
How does Gmail login work?
Through OAuth2. You authorize once on Google's consent screen — no password is ever stored. The installation needs a one-time OAuth client set up in Google Cloud Console with the Gmail API enabled. For other providers, use an app password, encrypted with Fernet.
Does it replace Odoo's incoming mail or Discuss?
No. It is a separate personal mailbox app. Discuss keeps handling chatters, internal messages and system notifications. The only touch point is linking a message into a record's chatter.
Can each user have several accounts?
Yes. Accounts are per user (one or many) and fully isolated by record rules — every user sees only their own. An administrator group can see all accounts for diagnostics.
What does linking to a record do?
One click attaches the email to a contact, lead, order, task or ticket. A copy is posted to that record's chatter as a note, so the whole conversation lives in one place — right where your team already works.
What are the requirements?
Odoo 19 (Community or Enterprise) plus the Python packages imapclient and cryptography — and google-auth for Gmail OAuth. The module depends on base, mail and web.
Bring your inbox into Odoo
Read, reply and link your email to the records that matter — without leaving Odoo. Get in touch for a quote or a live demo.
Request a quote → Visit perp.plMarius Kuc
odoo.com.pl
Odoo apps & implementation
Legal note: Mail Client Pro is a proprietary Odoo module distributed under OPL-1. Odoo is a trademark of Odoo S.A. Gmail and Google are trademarks of Google LLC, referenced here for compatibility only.
© 2026 perp.pl · Marius Kuc · www.perp.pl