Embed Mattermost within Microsoft Teams

plans-img Available on all plans

deployment-img Cloud and self-hosted deployments

Using the Mattermost for Microsoft Teams integration, you can choose to embed your Mattermost workspace within your Microsoft Teams instance and take advantage of embedded app features.

Important

You must install the Mattermost for Microsoft Teams integration before you can embed the Mattermost app within Microsoft Teams.

To embed the Mattermost app within Microsoft Teams:

  1. In Mattermost, as an administrator, go to System Console > Plugins > MSTeams Sync. At the bottom of the settings page, select Download Manifest to download a ZIP file containing the Microsoft Teams application manifest pre-configured for your Mattermost workspace.

  2. In Microsoft Teams, as an administrator, go to the Microsoft Teams admin center under Teams Apps > Manage Apps, or use the following URL: https://admin.teams.microsoft.com/policies/manage-apps.

  3. Select Upload new app, then upload the app manifest you downloaded in the previous step.

You’re all set! The Mattermost app is now available to everyone in your Microsoft Teams workspace.

Pin the Mattermost app in Microsoft Teams

  1. Add the Mattermost app by selecting Apps within the left-hand sidebar, select Add located next to the Mattermost for Microsoft Teams app, then select Add again. Once added, your Mattermost workspace is now embedded in your Microsoft Teams instance.

  2. Pin the Mattermost app in your left-hand sidebar, to access it easily in the future, by right-clicking the Mattermost tab and selecting Pin.

  3. Sign in with your credentials, and use the Mattermost app to collaborate with technical and operations teams.

Demonstration: Embed Mattermost within Microsoft Teams

Check out this YouTube demo, from Doug Lauder, Senior Software Design Engineer at Mattermost, to learn how to embed Mattermost within Microsoft Teams:

Get users started with the embedded app

See our end user documentation for a video walkthrough of using Mattermost embedded within Microsoft Teams.

Limitations

The embedded Mattermost app currently only supports email/password log in to the Mattermost workspace. SSO authentication with SAML 2.0 providers (Okta, OneLogin, Microsoft ADFS) and with your Microsoft365 account are under consideration.

Get help

If you face any issues while installing or using the app in Microsoft Teams, you can either: