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

# Jira

> Create issues, manage sprints, and track project progress in Jira — all from Mantle conversations and AI agents

Connect your Jira account via OAuth and let your AI agents manage issues, search with JQL, track sprints, and keep your
team updated — without leaving Mantle.

***

## What you unlock

<CardGroup cols={2}>
  <Card title="Issue management" icon="circle-check">
    Create, edit, assign, and transition issues directly from chat or through an agent.
  </Card>

  <Card title="JQL search" icon="magnifying-glass">
    Search issues using JQL queries, filter by project, status, assignee, or any field — all through natural language.
  </Card>

  <Card title="Sprint tracking" icon="gauge-high">
    List boards, view sprints, and move issues between sprints to keep your team on track.
  </Card>

  <Card title="Project overview" icon="diagram-project">
    Browse projects, check versions, view components, and manage workflows across your Jira instance.
  </Card>
</CardGroup>

***

## Connect Jira

<Steps>
  <Step title="Open Settings → Integrations">
    In any workspace go to **Settings → Integrations** and select **Jira**.
  </Step>

  <Step title="Authorize with OAuth">
    Click **Connect** and sign in to your Atlassian account. Grant Mantle the requested permissions to access your Jira
    data.
  </Step>

  <Step title="Confirm the connection">
    Once authorized, you'll be redirected back to Mantle. The integration status will show as connected.
  </Step>
</Steps>

***

## Agent tools

Add Jira tools to agents that need them. Their access is limited by the connected account and selected tools.

### Issues

| Tool             | Description                                                  |
| ---------------- | ------------------------------------------------------------ |
| Create issue     | Create a new issue with type, summary, description, and more |
| Get issue        | Retrieve full details of an issue by key or ID               |
| Edit issue       | Update fields on an existing issue                           |
| Assign issue     | Assign or reassign an issue to a team member                 |
| Search issues    | Search issues using JQL queries                              |
| Transition issue | Move an issue to a different workflow status                 |
| Add comment      | Post a comment on an issue                                   |
| Add attachment   | Attach a file to an issue                                    |

### Projects & Versions

| Tool              | Description                                |
| ----------------- | ------------------------------------------ |
| Get project       | Retrieve project details and configuration |
| List projects     | List all projects in the Jira instance     |
| Create version    | Create a new version/release in a project  |
| Get components    | List components in a project               |
| Get project roles | View roles assigned to a project           |

### Sprints & Boards

| Tool           | Description                       |
| -------------- | --------------------------------- |
| List boards    | List all boards (Scrum, Kanban)   |
| List sprints   | List sprints for a specific board |
| Create sprint  | Create a new sprint               |
| Move to sprint | Move an issue into a sprint       |

### Users & Permissions

| Tool             | Description                               |
| ---------------- | ----------------------------------------- |
| Get current user | Retrieve the authenticated user's profile |
| Find users       | Search for users by name or email         |
| Get permissions  | Check permissions for the current user    |

***

## Triggers

<Note>
  Automated triggers for Jira are not yet available. Triggers will be added in a future update — check back soon.
</Note>

***

## Example use cases

<AccordionGroup>
  <Accordion title="Create a bug report from a chat message">
    Someone describes a bug in chat. Instead of switching to Jira, ask your agent to create a Bug issue with the right
    project, priority, and description — it fills in the details from the conversation context.
  </Accordion>

  <Accordion title="Daily standup summary">
    An agent runs a JQL query each morning to find issues that changed status yesterday, groups them by assignee, and
    posts a standup summary to your team channel.
  </Accordion>

  <Accordion title="Sprint progress check">
    Ask your agent "How is the current sprint going?" and it lists the board's active sprint, counts issues by status,
    and highlights anything blocked or overdue.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="OAuth connection failed">
    Make sure you are signing in with an Atlassian account that has access to the Jira instance you want to connect. If
    the connection fails, try disconnecting and reconnecting from **Settings → Integrations → Jira**.
  </Accordion>

  <Accordion title="Agent can't find my project">
    The connected account must have permission to view the project in Jira. Check your Jira project permissions and
    ensure the authenticating user has at least browse access.
  </Accordion>

  <Accordion title="JQL search returns no results">
    Verify your JQL syntax is correct. Use the agent to help construct JQL queries — it can translate natural language
    like "show me open bugs assigned to me" into valid JQL.
  </Accordion>

  <Accordion title="Issue transitions fail">
    Not all transitions are available from every status. Use the "Get transitions" tool to see which transitions are
    valid for the issue's current state.
  </Accordion>
</AccordionGroup>

***

<Card title="Back to Integrations" icon="plug" href="/integrations/overview">
  View all available integrations
</Card>