Follow on this guide to install and setup Microsoft Teams Jira Connector and the companion Microsoft Teams Bot.

This guide will show you how to setup Microsoft Teams Jira Connector for the first time. There are two components of this service - Microsoft Teams App and Jira App.

General setup process

  1. You need to have installed the Microsoft Teams Jira Connector application in Jira.

  2. You need to have installed Jira Connector application in Microsoft Teams.

  3. Microsoft Teams administrator needs to consent permissions for Microsoft Teams Jira Connector to allow it to perform the operations it needs to perform. This link can be used to consent. The same link available in the Jira System settings page.

  4. After you have installed the 2 apps above, Jira admin needs to connect Microsoft Teams and Jira (let’s call it tenant mapping). Where you will say your Microsoft tenants is linked to your Atlassian Jira tenant. Using connect jira command in Microsoft Teams.

  5. When the tenants are mapped, any Microsoft Teams user can map his or her account to the corresponding Atlassian Jira account. This is done using connect command in Microsoft Teams.

  6. Consent the Microsoft Teams Jira Connector app to allow interact with Microsoft Graph API for your organization. This is required to create issue discussion channels.

Tenant mapping

When both apps are installed Jira administrator needs to follow these steps.

Demo video:

  1. Navigate to the Microsoft Teams page in system settings and find there Bot Connection Token (at the bottom of the page).

    2. Afterwards, open a one on one conversation with Jira Connector in Microsoft Teams and type connect jira . Please enter the corresponding token and press Connect Jira button.

    3. Connect your tenant and user by clicking the Connect button on the card. You will be redirected to your Jira instance where you need to click the only available button to map your accounts.

    4. When this is done the Microsoft Teams card should update to the following.

User mapping

User mapping is very similar process (for Jira admin it is done during the tenant mapping and explained above).

Demo video:

To map your Microsoft Teams and Atlassian Jira accounts you need to type connect in one on one conversation with the Microsoft Teams Jira Connector bot.

When you press Connect button on the card you will end up in your Jira where you need to confirm the account mapping.

When the connection process is done the page should update to

and you should see the card similar to this one

When everything is connected you can move work forward with Microsoft Teams Jira Connector. The best way to start is to search for an issue using free text or JQL search.


In order to allow Microsoft Teams Jira Connector app to create channels to discussion Jira issues Microsoft Teams administrator needs to consent required permissions.

The consent process started by click on the consent link in the configuration or issue page.

Or you can use this link.

If you don’t have permissions to consent you will see the following message, so you need to help your Microsoft Teams admin to consent.

Get help

If you need help please do not hesitate to contact us.