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

# Jira

> Search, create, and manage Jira issues and projects

## At a glance

* **Availability**: Enabled by default.
* **Auth**: OAuth 2.0.
* **Connection**: A user authorizes the connection in the provider's consent screen.
* **Scopes**: `read:jira-work`, `write:jira-work`, `read:jira-user`, `offline_access`.

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.

| Variable                  | Required | Description                                                                                            |
| ------------------------- | -------- | ------------------------------------------------------------------------------------------------------ |
| `ATLASSIAN_CLIENT_ID`     | Yes      | Atlassian OAuth 2.0 Client ID (from your app) [Docs](https://developer.atlassian.com/console/myapps/). |
| `ATLASSIAN_CLIENT_SECRET` | Yes      | Atlassian OAuth 2.0 Client Secret [Docs](https://developer.atlassian.com/console/myapps/).             |

## Tools

| Tool                 | Access | Description                                                                                                                   |
| -------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| List Atlassian Sites | Read   | List Atlassian cloud sites/resources the OAuth token can access; use the returned id as cloudId for Jira and Confluence tools |
| List Projects        | Read   | List all accessible Jira projects                                                                                             |
| Get Project          | Read   | Get detailed information about a Jira project                                                                                 |
| Search Issues        | Read   | Search Jira issues using JQL (Jira Query Language)                                                                            |
| Get Issue            | Read   | Get detailed information about a specific Jira issue                                                                          |
| Create Issue         | Write  | Create a new Jira issue in a project                                                                                          |
| Update Issue         | Write  | Update an existing Jira issue (status, fields, etc.)                                                                          |
| List Comments        | Read   | List comments on a Jira issue                                                                                                 |
| Add Comment          | Write  | Add a comment to a Jira issue                                                                                                 |
| Get Transitions      | Read   | List available workflow transitions for a Jira issue                                                                          |
| Transition Issue     | Write  | Move a Jira issue to a new workflow status. First call get\_transitions to get valid transition IDs, then pass the ID here.   |
| Search Users         | Read   | Search Jira users by name or email to find the accountId needed for assigning issues                                          |

## Example prompts

* Search for all open bugs assigned to me or in my current sprint.
* Create a new task in Jira with a title, description, and priority.
* Get a summary of all issues in the current sprint, organized by status.
* Move an issue to a different status (To Do, In Progress, Done, etc.).