Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time
June 18, 2022 12:37
June 1, 2022 17:40
April 21, 2021 18:25
June 4, 2022 18:12
June 9, 2022 07:13
June 7, 2022 09:44
June 2, 2022 18:56
December 5, 2019 14:30
April 10, 2018 14:08
May 27, 2022 22:06
June 20, 2022 14:58


Message Header Analyzer mail app.

This is the source for the Message Header Analyzer. Install the app from the store here:

Installation Procedure

Because MHA requires the ReadWriteMailbox permission it can only be installed by the Administrator through the Exchange admin center or by a user as a custom addon. Here are some steps I put together:

  1. In Office365, go to the Exchange Admin Center.
  2. Click on the Organization tab
  3. From there, select the add-ins tab
  4. Click the Plus icon/Add from the Office Store
  5. A new page will load for the store
  6. Search for "Message Header Analyzer"
  7. Choose MHA in the results
  8. Click Add
  9. Confirm by clicking Yes
  10. Back in the Exchange Admin Center, refresh the list of add-ins
  11. You can now edit who the add-in is available for

A Note on Permissions

In order to get the transport message headers I have to use the EWS makeEwsRequestAsync method, which requires the ReadWriteMailbox permission level. See the article Understanding Outlook add-in permissions for more on this. If I could request fewer permissions I would, since I only ever read the one property, but I have no choice in the matter.

When REST is more widely available, and a few REST specific bugs are fixed, I'll be able to switch to REST and request a lower permission level.


Here is a standalone Message Header Analyzer running the same backend code as the MHA app:

Unit Tests


For both IOS and Android click open an email, then press the three dots under the date. There you should see the MHA icon. See outlook-mobile-addins page for more details.

Development & Custom Deployment

  • Clone the repo to your local drive
  • npm install
  • npm start