Skip to main content

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.
Service accounts navigation
  1. Click the Create a service account button in the top right corner.
Create a service account button
  1. Provide a name (e.g., matterai-jira) and description for your service account, then click Next.
Name your service account
  1. In the Select app roles step, find Jira from the list of apps and assign it the User role.
Select app roles for Jira

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.
Create credentials
  1. Choose API token as your authentication type and click Next.
Choose API token authentication
  1. Give your token a name (such as matterai-jira-token), select an expiration date, and click Next.
Name API token and set expiration
  1. 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.
Select token scopes
  1. Review your API token details. Make sure the configuration is correct, then click Create.
Review API token
  1. Copy the generated API token. Save it somewhere safe, as you won’t be able to retrieve it again. Click Done.
Copy API token

Step 3: Connect to MatterAI

  1. Visit the MatterAI web app 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.
Configure Jira in MatterAI Connectors
You are now successfully connected! MatterAI can now interact with your Jira workspace.