Skip to Content
Q&A

Installing the Odoo Outlook Plugin on Windows and macOS

Create leads, contacts, and tasks without leaving your inbox

18-06-2026 DAADit Group, Nick 26 min read
Admin Configuration Email Tips & Tricks
Back to all Q&A
June 18, 2026 by
Installing the Odoo Outlook Plugin on Windows and macOS
DAADit Group, Nick

Email remains one of the most important channels for customer contact. But anyone who has ever manually retyped leads from Outlook into Odoo knows how much time that takes — and how much information gets lost along the way. The Odoo Outlook plugin solves that: you create leads, opportunities, tasks and contacts directly from an open email, without switching tabs.

In this post we show what the plugin does and how to install it on Windows, macOS and Outlook on the web.

What can the Odoo Outlook plugin do?

Once the plugin is activated, an Odoo panel appears next to your email. From that panel you can:

  • Look up contacts in Odoo based on the sender's email address
  • Create new contacts or leads with a single click — name, email and company details are filled in automatically
  • Log emails as a message under an existing lead, opportunity or customer record
  • Create tasks or opportunities directly from the email view
  • Retrieve enriched company information via Odoo's IAP service (depending on your subscription)

In short: your inbox becomes an extension of your CRM.

What do you need?

From Odoo 15 onwards, Odoo hosts the manifest file centrally — so you do not need to generate anything from your own environment. You use the same manifest URL for all installations:

https://download.odoocdn.com/plugins/outlook/manifest.xml

You only need your own Odoo URL and login details the first time you open the plugin in Outlook — that is when you link it to your instance.

Using CRM or Helpdesk? Make sure the corresponding modules (mail_plugin, crm_mail_plugin, helpdesk_mail_plugin, project_mail_plugin) are installed in Odoo. Without these modules you will see contacts, but no leads, tickets or tasks in the panel.

Installation on Windows (Outlook desktop)

  1. Open Outlook on your Windows machine.
  2. Click the Home tab at the top and choose Get Add-ins (or in older versions: File → Manage Add-ins).
  3. In the window that opens, choose My add-ins on the left.
  4. Scroll to Custom add-ins and click + Add a custom add-in → Add from URL.
  5. Paste the manifest URL: https://download.odoocdn.com/plugins/outlook/manifest.xml and confirm with OK.
  6. Accept the warning about custom add-ins and click Install.
  7. Close the window. An Odoo button now appears in the Outlook ribbon for every open email.

The first time you click the Odoo button, the plugin asks for your Odoo URL (e.g. https://yourcompany.odoo.com) and then logs you in via the regular Odoo login page. After that, the session stays active.

Installation on macOS

Please note: in current versions of Outlook for Mac, the «Get Add-ins» button opens the Microsoft AppSource store in your browser. You cannot enter a custom manifest URL there. The only working route on the Mac is therefore: install the add-in via Outlook on the web with the same Microsoft 365 account, and the plugin syncs automatically to your Mac Outlook.

How it works via Outlook on the web

  1. Close Outlook for Mac (or leave it running in the background — it reloads the add-in automatically after synchronisation).
  2. In your browser, open outlook.office.com and log in with the same Microsoft 365 account you use on your Mac.
  3. Open any email and click the … menu (more actions) at the top right → Get Add-ins.
  4. Kies links Mijn invoegtoepassingen.
  5. Scroll to Custom add-ins and click + Add a custom add-in → Add from URL.
  6. Paste: https://download.odoocdn.com/plugins/outlook/manifest.xml and confirm with OK.
  7. Accept the warning and click Install.
  8. Open Outlook on your Mac again. Within a few minutes the Odoo button appears in the action bar of an open email (puzzle-piece icon → Odoo).

Button not showing up straight away? Fully restart Outlook for Mac (Cmd+Q) or wait up to 15 minutes — add-ins are synchronised per user from Exchange Online.

Alternative: central rollout via the Microsoft 365 administrator

Managing several Mac users? Have the Microsoft 365 administrator roll out the add-in once via the Microsoft 365 admin centre → Settings → Integrated apps → Upload custom apps, using the same CDN URL. Users then do not need to do anything themselves — the plugin appears automatically in their Outlook, including on the Mac.

Installation in Outlook on the web (Microsoft 365)

Do you mainly work via the browser? Then you are effectively already done with the steps above under macOS. For completeness:

  1. Open outlook.office.com and log in.
  2. Open any email.
  3. Click the … menu at the top right of the email and choose Get Add-ins.
  4. Go to My add-ins → Custom add-ins.
  5. Click + Add a custom add-in → Add from URL.
  6. Paste: https://download.odoocdn.com/plugins/outlook/manifest.xml and confirm.
  7. Click Install.

The Odoo button now appears in the action bar of every email.

Connecting to your Odoo instance for the first time

Regardless of where you installed the add-in: the first time you open it in an email, you will see a small panel with an input field. Enter your Odoo URL there (e.g. https://yourcompany.odoo.com) and click Log in. You are redirected to the standard Odoo login page, and after a successful login the connection is retained — you only need to do this once per device.

Veelvoorkomende problemen

ProbleemOplossing
On Mac, Get Add-ins opens AppSource in the browserThis is intended behaviour in the current Outlook for Mac. Sideloading is blocked in the desktop app — install the plugin via Outlook on the web (outlook.office.com). The add-in syncs automatically to your Mac.
"Add a custom add-in" is greyed outYour Microsoft 365 administrator has blocked sideloading. Ask them to roll out the add-in centrally via the Microsoft 365 admin centre.
Plugin loads endlessly or cannot connectCheck that you are entering the correct Odoo URL (with https://) and that your Odoo user has access to Contacts & CRM.
Unable to log inMake sure third-party cookies are allowed for your Odoo domain in the browser Outlook runs in.
Knop verdwenen na updateReinstall the add-in via My add-ins, or wait for the Exchange synchronisation to restore the add-in (up to 24 hours).

Conclusie

With the Odoo Outlook plugin you bring CRM and inbox together in the place where your sales team already spends most of the day. Installation takes five minutes, and the weekly time saving is considerable — especially for sales and support staff who process dozens of emails a day.

Want to roll out the plugin for your whole team in one go? You can, via the Microsoft 365 admin centre → Settings → Integrated apps with the same CDN URL — then nobody needs to install anything manually, and it works immediately on both Windows and Mac.

Tip: test the plugin with a single sales user first before rolling it out company-wide — that way you know for sure the right Odoo modules are enabled and the permissions are correct. Getting stuck during the rollout, or would you like us to review your entire CRM setup while we are at it? Contact DAADit Group — we are happy to help you get started.

Email remains one of the most important channels for customer contact. But anyone who has ever manually retyped leads from Outlook into Odoo knows how much time that costs — and how much information gets lost along the way. The Odoo Outlook plugin solves that: you create leads, opportunities, tasks and contacts directly from an open email, without switching tabs.

In this post we show what the plugin does and how you install it on Windows, macOS and Outlook on the web.

What can the Odoo Outlook plugin do?

Once the plugin is activated, an Odoo panel appears next to your email. From that panel you can:

  • Look up contacts in Odoo based on the sender's email address
  • Create new contacts or leads with one click — name, email and company details are filled in automatically
  • Log emails as a message under an existing lead, opportunity or customer record
  • Create tasks or opportunities directly from the email view
  • Retrieve enriched company information via Odoo's IAP service (depending on your subscription)

In short: your inbox becomes an extension of your CRM.

What do you need?

From Odoo 15 onwards, Odoo hosts the manifest file centrally — so you don't have to generate anything from your own environment. You use the same manifest URL for all installations:

https://download.odoocdn.com/plugins/outlook/manifest.xml

You only need your own Odoo URL and login credentials the first time you open the plugin in Outlook — that's when you link it to your instance.

Are you using CRM or Helpdesk? Make sure the corresponding modules (mail_plugin, crm_mail_plugin, helpdesk_mail_plugin, project_mail_plugin) are installed in Odoo. Without these modules you will see contacts, but no leads, tickets or tasks in the panel.

Installation on Windows (Outlook desktop)

  1. Open Outlook on your Windows machine.
  2. At the top, click the Home tab and choose Get Add-ins (or in older versions: File → Manage Add-ins).
  3. In the window that opens, choose My add-ins on the left.
  4. Scroll to Custom add-ins and click + Add a custom add-in → Add from URL.
  5. Paste the manifest URL: https://download.odoocdn.com/plugins/outlook/manifest.xml and confirm with OK.
  6. Accept the warning about custom add-ins and click Install.
  7. Close the window. An Odoo button now appears in the Outlook ribbon for every opened email.

The first time you click the Odoo button, the plugin asks for your Odoo URL (e.g. https://yourcompany.odoo.com) and then logs you in via the regular Odoo login page. After that the session stays active.

Installation on macOS

Note: in the current versions of Outlook for Mac, the «Get Add-ins» button opens the Microsoft AppSource store in your browser. You cannot enter a custom manifest URL there. The only working route on the Mac is therefore: install the add-in via Outlook on the web with the same Microsoft 365 account, and the plugin syncs automatically to your Mac Outlook.

Procedure via Outlook on the web

  1. Close Outlook for Mac (or leave it running in the background — it will reload the add-in automatically after synchronization).
  2. In your browser, open outlook.office.com and log in with the same Microsoft 365 account that you use on your Mac.
  3. Open any email and click the … menu (more actions) at the top right → Get Add-ins.
  4. Choose My add-ins on the left.
  5. Scroll to Custom add-ins and click + Add a custom add-in → Add from URL.
  6. Paste: https://download.odoocdn.com/plugins/outlook/manifest.xml and confirm with OK.
  7. Accept the warning and click Install.
  8. Reopen Outlook on your Mac. Within a few minutes the Odoo button appears in the action bar of an opened email (puzzle-piece icon → Odoo).

Doesn't the button appear right away? Fully restart Outlook for Mac (Cmd+Q) or wait up to 15 minutes — add-ins are synchronized per user from Exchange Online.

Alternative: central rollout via the Microsoft 365 administrator

Do you manage multiple Mac users? Have the Microsoft 365 administrator roll out the add-in once via the Microsoft 365 admin center → Settings → Integrated apps → Upload app, with the same CDN URL. Users then don't have to do anything themselves — the plugin appears automatically in their Outlook, also on the Mac.

Installation in Outlook on the web (Microsoft 365)

Do you mainly work via the browser? Then you are in fact already done with the steps above under macOS. For completeness:

  1. Open outlook.office.com and log in.
  2. Open any email.
  3. At the top right of the email, click the … menu and choose Get Add-ins.
  4. Go to My add-ins → Custom add-ins.
  5. Click + Add a custom add-in → Add from URL.
  6. Paste: https://download.odoocdn.com/plugins/outlook/manifest.xml and confirm.
  7. Click Install.

The Odoo button now appears in the action bar of every email.

Connecting to your Odoo instance for the first time

Regardless of where you installed the add-in: the first time you open it in an email, you see a small panel with an input field. Enter your Odoo URL there (e.g. https://yourcompany.odoo.com) and click Log in. You are redirected to the standard Odoo login page, and after successful login the connection is retained — you only have to do this once per device.

Common problems

ProblemSolution
On Mac, Get Add-ins opens AppSource in the browserThis is intended behavior in the current Outlook for Mac. Sideloading is blocked in the desktop app — install the plugin via Outlook on the web (outlook.office.com). The add-in syncs automatically to your Mac.
"Add a custom add-in" is greyed outYour Microsoft 365 administrator has blocked sideloading. Ask them to roll out the add-in centrally via the Microsoft 365 admin center.
Plugin loads endlessly or cannot connectCheck that you enter your correct Odoo URL (with https://) and that your Odoo user has access to Contacts & CRM.
Login failsMake sure third-party cookies are allowed for your Odoo domain in the browser on which Outlook runs.
Button disappeared after an updateReinstall the add-in via My add-ins, or wait for the Exchange synchronization to restore the add-in (up to 24 hours).

Conclusion

With the Odoo Outlook plugin you bring CRM and inbox together in the place where your commercial team already spends most of the day anyway. The installation takes five minutes, the weekly time saving is considerable — especially for sales and support staff who process dozens of emails every day.

Do you want to roll out the plugin for your entire team in one go? You can do that via the Microsoft 365 admin center → Settings → Integrated apps with the same CDN URL — then no one has to install manually anymore, and it works right away on both Windows and Mac.

Tip: pilot the plugin with one sales user before rolling it out company-wide — that way you know the right Odoo modules are installed and the access rights are correct. Stuck during rollout, or want us to review your whole CRM setup while we're at it? Contact DAADit Group — we are happy to help you get going.

in Odoo

Question not answered?

Our Odoo consultants are happy to think along with you. Book a no-obligation intro call.

Book an appointment
A 100% score on internet.nl: Here’s how to get all the checkmarks to turn green
DNSSEC, SPF, DMARC, DKIM, STARTTLS, DANE, IPv6 — from a red page to 100% in a single coordinated sprint.