> ## Documentation Index
> Fetch the complete documentation index at: https://docs.matterai.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira Integration

> Connect your Atlassian Jira account to MatterAI

# MatterAI Jira Integration

Connect your Atlassian Jira account to MatterAI to seamlessly search, fetch tasks, and interact with all your Jira content directly within MatterAI.

Follow these steps to integrate MatterAI with your Jira Workspace:

## Step 1: Create a Service Account

1. Go to your **Atlassian Administration** dashboard (e.g., `admin.atlassian.com`).
2. Navigate to **Directory** > **Service accounts** from the left sidebar.

<Frame>
  <img src="https://mintcdn.com/gravitycloud-9ebb5c50/3oyBnqwH_XC6FeJY/images/connectors/jira/jira-integration-1.png?fit=max&auto=format&n=3oyBnqwH_XC6FeJY&q=85&s=071c78f64cb45aa9d828c333157a0393" alt="Service accounts navigation" className="block" width="2940" height="1912" data-path="images/connectors/jira/jira-integration-1.png" />
</Frame>

3. Click the **Create a service account** button in the top right corner.

<Frame>
  <img src="https://mintcdn.com/gravitycloud-9ebb5c50/3oyBnqwH_XC6FeJY/images/connectors/jira/jira-integration-2.png?fit=max&auto=format&n=3oyBnqwH_XC6FeJY&q=85&s=6bbce702899c8f4538d01e2bab2d25e0" alt="Create a service account button" width="2940" height="1912" data-path="images/connectors/jira/jira-integration-2.png" />
</Frame>

4. Provide a name (e.g., `matterai-jira`) and description for your service account, then click **Next**.

<Frame>
  <img src="https://mintcdn.com/gravitycloud-9ebb5c50/3oyBnqwH_XC6FeJY/images/connectors/jira/jira-integration-3.png?fit=max&auto=format&n=3oyBnqwH_XC6FeJY&q=85&s=41aa872c15d986e054c27807d479e3ef" alt="Name your service account" width="2940" height="1912" data-path="images/connectors/jira/jira-integration-3.png" />
</Frame>

5. In the **Select app roles** step, find **Jira** from the list of apps and assign it the **User** role.

<Frame>
  <img src="https://mintcdn.com/gravitycloud-9ebb5c50/3oyBnqwH_XC6FeJY/images/connectors/jira/jira-integration-4.png?fit=max&auto=format&n=3oyBnqwH_XC6FeJY&q=85&s=52710401ce5b5e33a5be0798bf04e50d" alt="Select app roles for Jira" width="2940" height="1912" data-path="images/connectors/jira/jira-integration-4.png" />
</Frame>

## Step 2: Generate an API Token

1. After the service account is successfully created, click on the **Create credentials** button on the service account page.

<Frame>
  <img src="https://mintcdn.com/gravitycloud-9ebb5c50/3oyBnqwH_XC6FeJY/images/connectors/jira/jira-integration-5.png?fit=max&auto=format&n=3oyBnqwH_XC6FeJY&q=85&s=ee8dff9981964156ef64b0fa7273583b" alt="Create credentials" width="2940" height="1912" data-path="images/connectors/jira/jira-integration-5.png" />
</Frame>

2. Choose **API token** as your authentication type and click **Next**.

<Frame>
  <img src="https://mintcdn.com/gravitycloud-9ebb5c50/3oyBnqwH_XC6FeJY/images/connectors/jira/jira-integration-6.png?fit=max&auto=format&n=3oyBnqwH_XC6FeJY&q=85&s=fa623f5b37f69a5bddba5c69e0a15959" alt="Choose API token authentication" width="2940" height="1912" data-path="images/connectors/jira/jira-integration-6.png" />
</Frame>

3. Give your token a name (such as `matterai-jira-token`), select an expiration date, and click **Next**.

<Frame>
  <img src="https://mintcdn.com/gravitycloud-9ebb5c50/3oyBnqwH_XC6FeJY/images/connectors/jira/jira-integration-7.png?fit=max&auto=format&n=3oyBnqwH_XC6FeJY&q=85&s=c8cb3b1fb5608a4e820a2213f6cae386" alt="Name API token and set expiration" width="2940" height="1912" data-path="images/connectors/jira/jira-integration-7.png" />
</Frame>

4. In the **Select token scopes** screen, search for and select the `read:jira-work` scope. This allows MatterAI to fetch your Jira issues and project data. Then, click **Next**.

<Frame>
  <img src="https://mintcdn.com/gravitycloud-9ebb5c50/3oyBnqwH_XC6FeJY/images/connectors/jira/jira-integration-8.png?fit=max&auto=format&n=3oyBnqwH_XC6FeJY&q=85&s=7facdcad6a0b6299a4af3af43b919d85" alt="Select token scopes" width="2940" height="1912" data-path="images/connectors/jira/jira-integration-8.png" />
</Frame>

5. Review your API token details. Make sure the configuration is correct, then click **Create**.

<Frame>
  <img src="https://mintcdn.com/gravitycloud-9ebb5c50/3oyBnqwH_XC6FeJY/images/connectors/jira/jira-integration-9.png?fit=max&auto=format&n=3oyBnqwH_XC6FeJY&q=85&s=773ca72204e8901c1971b485f51ac95e" alt="Review API token" width="2940" height="1912" data-path="images/connectors/jira/jira-integration-9.png" />
</Frame>

6. Copy the generated API token. **Save it somewhere safe**, as you won't be able to retrieve it again. Click **Done**.

<Frame>
  <img src="https://mintcdn.com/gravitycloud-9ebb5c50/3oyBnqwH_XC6FeJY/images/connectors/jira/jira-integration-10.png?fit=max&auto=format&n=3oyBnqwH_XC6FeJY&q=85&s=48e3233b053dc3b635c46b501640d2ab" alt="Copy API token" width="2940" height="1912" data-path="images/connectors/jira/jira-integration-10.png" />
</Frame>

## Step 3: Connect to MatterAI

1. Visit the MatterAI web app [https://app.matterai.so/connectors](https://app.matterai.so/connectors) and navigate to **Connectors** on the left menu.
2. Under the **JIRA** connector card, click the **Connect** button.
3. In the JIRA Settings modal, enter your **JIRA Base URL** (e.g., `https://your-company.atlassian.net`).
4. Paste the **JIRA API Token** you copied during the previous step into the token field.
5. Click **Save** to complete the integration.

<Frame>
  <img src="https://mintcdn.com/gravitycloud-9ebb5c50/3oyBnqwH_XC6FeJY/images/connectors/jira/jira-integration-11.png?fit=max&auto=format&n=3oyBnqwH_XC6FeJY&q=85&s=d78447a6a4d3d96edc1542a5658f9e61" alt="Configure Jira in MatterAI Connectors" width="2940" height="1612" data-path="images/connectors/jira/jira-integration-11.png" />
</Frame>

You are now successfully connected! MatterAI can now interact with your Jira workspace.
