Install the Mattermost for Microsoft Teams plugin 

plans-img Available on all plans

deployment-img Cloud and self-hosted deployments

To install the Mattermost for Microsoft Teams plugin in Mattermost:

  1. Log in to your Mattermost workspace as a system administrator.

  2. Download the latest version of the plugin binary release, compatible with Mattermost v8.0.1 and later.

Tip

If you are using an earlier version of Mattermost, follow our documentation to upgrade to Mattermost v8.0.1 or later.

  1. Go to System Console > Plugins > Plugin Management > Upload Plugin, and upload the plugin binary you downloaded in the previous step.

  2. Go to System Console > Plugins > Plugin Management. In the Installed Plugins section, scroll to MS Teams Sync, and select Enable Plugin.

Configure how users will connect accounts 

Mattermost admins can configure Mattermost to automatically prompt users to connect their Mattermost user account to their Microsoft Teams user account on login.

  1. Go to System Console > Plugins > MS Teams Sync.

  2. Enable Enforce connected accounts to prompt users to connect if they haven’t done so.

  3. (Optional) Enable Allow to temporarily skip connect user to allow users to skip the connection prompt temporarily. Users are prompted on refresh and login.

Configure the plugin 

Additional configuration settings are available for this plugin. See the MS Teams Sync plugin configuration settings documentation for details.

Get started with the plugin 

See our collaborate using Mattermost for MS Teams documentation for details on how to collaborate across both Mattermost and Microsoft Teams at the same time.

Troubleshooting 

If you encounter issues when connecting user accounts or linking channels, we recommend restarting the plugin as a Mattermost system admin.

  1. Go to System Console > Plugins > Plugin Management.

  2. Under Installed Plugins, scroll to the MSTeams Sync section, select Disable then wait for the State to change to Not running.

  3. Select Enable and wait for the State to change to Running.

Get help 

If you face any issues while installing the Mattermost for Microsoft Teams Sync plugin, you can either: