harmon.ie App is an add-in for Outlook and Office that gives you easy access to SharePoint.

harmon.ie App for Outlook works on Windows, Mac, and Web Browser.

harmon.ie App for Office works in Word, Excel and PowerPoint for Windows, Mac, and Office Online.

Supported versions:

  • OWA & Office Online - Outlook, Word, Excel, and PowerPoint.
  • Outlook & Office for Windows - Outlook, Word, and PowerPoint version 16.0.82 or later. Excel is currently supported in Windows only when the app is sideloaded. Contact us if you wish to work with Excel.
  • Outlook & Office for Mac (macOS: High Sierra version 13.3.4 or later) - Outlook, Word and PowerPoint version 15.36 or later. Excel is currently not supported in Mac. Safari version 11.1.1 or later must be installed on the machine.

This article explains how to:

To install harmon.ie App for Office/Outlook:

To install the app for yourself:

  1. To install harmon.ie App for Office, open harmon.ie for Outlook.
    To install harmon.ie App for Outlook, open harmon.ie for Office.
  2. Click Get it Now and follow the installation instructions.
  3. Once the harmon.ie App buttons appear in the Home ribbon, click on one of them to launch the app.
  4. Click the Connect To Office 365 button.

To centrally install the app for your organization:

  1. Open the Microsoft 365 admin center.
  2. Select Settings > Services & add-ins.
  3. Click Deploy Add-In > Next > I want to add an Add-in from the Office Store > Next.
  4. Search for harmon.ie.
  5. Click the Add button next to harmon.ie for Office/Outlook.
  6. Click Who has access > Edit and grant access to Everyone or to Specific Users/Groups > Save.
  7. Click Save > Close.

For more information, read Manage deployment of Office 365 add-ins in the Office 365 admin center.

Note: If the URL of your Office 365 server ends with .de, contact us to receive a manifest file for the German Cloud.

To configure admin consent for accessing Office 365:

If the Integrated Apps option is turned off to prevent users from authorizing third-party apps to access Office 365 info, an admin consent is required to allow users to use the harmon.ie App. If this is not configured, users receive the error You can't access this application.

To grant harmon.ie App access permissions for the entire organization:

  1. Click the consent link.
  2. Sign in with Global Admin credentials and click Accept.

To configure MFA with harmon.ie App:

If your system is configured with Multi-Factor Authentication (MFA), you are required to configure trusted IPs for the harmon.ie App to work properly.

Configure these IPs as trusted:

  • 23.101.181.124
  • 23.101.185.142
  • 23.101.181.66
  • 23.101.185.75

For more information, read Enable the Trusted IPs feature by using service settings.

To provision SharePoint sites and ignored libraries:

Sites you define using this method appear in the user's app in the Sites section. Users cannot remove provisioned sites.

System libraries are ignored by default. You can change the list of ignored libraries, or define an empty list to show all libraries.

  1. Create a YAML file with an array of sites (either sub-sites or site collections) to display to the user, and list of libraries to hide from user.
  2. In the harmon.ie app, click the Settings icon ().
  3. Click Provisioning > Upload preferences.
  4. Select the YAML file you created in the first step.
  5. Click the Restart button to restart the app and see your changes.
    Note: The Restart button appears after a successful upload.

When you upload a new YAML file, sites that were previously provisioned and do not appear in the new YAML file are not removed from the user's app. Instead, they appear as enabled, and the user can remove them.

To create a YAML file:

  1. Create a sites YAML array with 2 properties for each site:
    • rootUrl - a decoded URL of the root site collection.
    • url - a decoded URL of the full path of the site.
    • The order of the sites in the YAML file is the order displayed to users.
  2. Create a ignoredLibraries YAML array with list of libraries to hide.
    By default, these libraries are hidden: Style Library, Site Assets, Form Templates, Site Newsfeed, Site Collection Documents, Site Collection Images, Workflow Tasks. If you do not want to change this list, don't define the ignoredLibraries array.
    To ignore system libraries names in other languages, you must set the ignoredLibraries array manually.
    If ignoredLibraries is defined in the file but left empty, no libraries are hidden.

Here is an example of a YAML file:

sites:
 -
  rootUrl: https://ravenwooddemo.sharepoint.com
  url: https://ravenwooddemo.sharepoint.com/LISA
 -
  rootUrl: https://ravenwooddemo.sharepoint.com/sites/Sales
  url: https://ravenwooddemo.sharepoint.com/sites/Sales/Sales Kit
 -
  rootUrl: https://ravenwooddemo.sharepoint.com
  url: https://ravenwooddemo.sharepoint.com/Construction
ignoredLibraries:
  - Style Library
  - Site Assets
  - Form Templates
  - Site Newsfeed

To configure email headers mapping:

  1. In the harmon.ie app, click the Settings icon ().
  2. Click Email Headers Mapping.
  3. Edit the Email Content Types and the SharePoint Columns matching each Email Header. You may supply multiple values separated by semicolons (;).
  4. Click Save.
  5. Select between:
    • Save for me: saves the email headers for yourself, without affecting other users.
    • Default for all users: saves the email headers for all users; users can edit the mappings.
    • Force for all users: saves the email headers for all users; users cannot edit the mappings.

To register a license:

Note: You must be connected to Office 365 to register a license.

  1. In the harmon.ie app, click the Settings icon ().
  2. In Windows / mobile: click Upload License, browse and select the license file (.lic) you received from harmon.ie and click Open.
  3. In Mac: Drag the license file to the Drop License Here box.
  4. Select between Upload license for me (register the license only for you, without affecting other users) and Upload license for all users.

To enable Sites I'm Following for all users

The following procedure enables the Sites I'm Following > Connect button for all users. The users should be directed to connect in order to view their followed sites from the harmon.ie app.

  1. In the harmon.ie app, click the Settings icon ().
  2. Under Sites I'm Following, click Enable.
  3. Supply your username and password.
  4. You are prompted to grant permissions to the harmon.ie app to access specified resources; click Accept.
  5. Click Close to return to the harmon.ie app.