About the add-on
The add-on uses Microsoft Graph to find the exact Outlook message by its RFC Message-ID. It then reads Outlook's reaction properties using delegated Exchange mailbox access because those properties are not included in normal IMAP messages or the Microsoft Graph message response.
Each Microsoft 365 mailbox must be connected separately. Multiple Thunderbird accounts are supported.
Setup instructions
The Entra registration and admin consent steps normally need to be completed by your Microsoft 365 administrator.
Part 1Register the Microsoft Entra application
- Open the Microsoft Entra admin center.
- Go to Identity → Applications → App registrations → New registration.
- Name the application
Thunderbird M365 Reactions. - Select Accounts in this organizational directory only, unless the same registration needs to be used across multiple Microsoft 365 tenants.
- Leave the redirect URI blank on the initial registration screen, then select Register.
- On the application overview page, copy the Application (client) ID and Directory (tenant) ID. You will enter both in the add-on later.
- Install the add-on using Part 2 below. Open its preferences and copy the displayed Entra SPA redirect URI.
- Return to the Entra application and open Authentication → Add a platform → Single-page application.
- Paste the exact redirect URI shown in the add-on and save it. Allow public client flows is not required and can remain disabled.
Add the required delegated permissions
- Open API permissions → Add a permission → Microsoft Graph → Delegated permissions.
- Add
Mail.ReadandUser.Read. - Select Add a permission again, then choose APIs my organization uses.
- Search for Office 365 Exchange Online, choose Delegated permissions, and add
EWS.AccessAsUser.All. - Select Grant admin consent for the configured permissions.
Part 2Install the Thunderbird add-on
- Open Thunderbird and select Add-ons and Themes.
- Open the gear menu and select Install Add-on From File….
- Select the downloaded
m365-reactions-thunderbird.xpifile and confirm the installation. - Open the M365 Reactions add-on's Preferences.
Part 3Connect each Microsoft 365 account
- In the add-on preferences, enter the Directory (tenant) ID and Application (client) ID created in Part 1.
- Select Save, then select Connect Microsoft account.
- Complete both Microsoft authorization windows. One authorizes Graph message lookup and the other authorizes access to the Exchange reaction properties.
- Confirm that the connected Microsoft email address matches the mailbox used by that Thunderbird account.
- Repeat these steps for every additional Microsoft 365 account configured in Thunderbird.
Using the add-on
- When an email has reactions, a reaction bar appears above the message body.
- Select Who reacted to see the names and email addresses associated with each reaction.
- Select Open Outlook to react to open the exact message in Outlook on the web.
- The first 50 messages in the displayed folder are prefetched and show an emoji/count pill for each reaction type.
- Reaction data is cached for five minutes. Use the refresh button in the Reactions popup to force an update.
Troubleshooting
No reactions appear for a message
Confirm that the same message shows reactions in Outlook on the web, that the correct Microsoft account is connected in the add-on preferences, and that Thunderbird is version 140 or newer. Use the refresh button in the Reactions popup to bypass the five-minute cache.
Microsoft asks me to sign in again
Microsoft limits refresh tokens issued to browser-based SPA clients. If interaction is required again, open the add-on preferences and select Connect Microsoft account to renew the session.
I cannot add or change a reaction
This is a Microsoft API limitation, not an installation problem. Select Open Outlook to react and change the reaction in Outlook on the web.
Thunderbird reports unrestricted access
Message-list reaction pills use a bundled Thunderbird Experiment because the standard MailExtension API cannot decorate message card rows. The Experiment injects the reaction pills and their stylesheet into Thunderbird's message-list view.
The add-on will not install
Confirm that Thunderbird 140 or newer is installed. Private unsigned builds may require temporary loading or signing depending on the Thunderbird release channel and your organization's add-on policy.
Technical limitations and data storage
- The Microsoft refresh token is stored in Thunderbird extension storage inside the local Thunderbird profile.
- Reaction data is cached locally for five minutes.
- Creating, changing, and removing reactions is not supported because Microsoft has not published an Outlook email reaction write API.
- Microsoft is retiring EWS in Exchange Online beginning October 2026 and plans full disablement by April 2027. Outlook reaction properties currently have no supported Microsoft Graph equivalent, so the add-on depends on EWS until Microsoft provides a replacement.