> For the complete documentation index, see [llms.txt](https://notara-1.gitbook.io/notara-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://notara-1.gitbook.io/notara-docs/connectors/jira.md).

# Jira

Read issues, search with JQL, and browse projects on Jira Cloud.

## What It Enables

| Tool                  | Capability | Description                                                       |
| --------------------- | ---------- | ----------------------------------------------------------------- |
| `search_issues`       | `read`     | Search issues using JQL (e.g. `project = ENG AND status != Done`) |
| `get_issue`           | `read`     | Get one issue with its full description as plain text             |
| `list_issue_comments` | `read`     | List an issue's comments, newest last                             |
| `list_projects`       | `read`     | List Jira projects with key, name, and lead                       |

All tools are read-only. Descriptions and comments are converted from Atlassian Document Format (ADF) to plain prose.

## Setup

**Required:** Atlassian account email + API token, and the Jira Cloud site URL (e.g. `https://acme.atlassian.net`).

**Where to find it:** [id.atlassian.com → Security → API tokens](https://id.atlassian.com/manage-profile/security/api-tokens)

1. In the Notara dashboard, go to **Tools**.
2. Click the **Jira** tile.
3. Go to Atlassian's API token page and click **Create API token**.
4. Copy the token.
5. Paste the token, your account email, and your site URL into the connector fields.
6. Click **Verify & Save**.

Your API token is encrypted at rest with AES-256-GCM.

## Example Prompts

> "What are all the open P1 bugs in the ENG project updated in the last week?"

> "Summarize the description and latest comments on ENG-423."

> "List all projects owned by the backend team."