Jira
Arcade toolkit · docs.arcade.dev
The Jira toolkit integrates Arcade with Atlassian Jira, enabling LLMs to manage issues, sprints, boards, users, attachments, and project metadata across Jira Cloud instances.
Capabilities
- Issue lifecycle management — Create, update, transition, search (parameterized or JQL), comment on, label, and attach files to issues; move issues between sprints and backlogs. Descriptions accept Markdown, and issues can carry components, fix versions, and custom fields.
- Sprint & board operations — List boards and their sprints (with date-range filtering), retrieve backlog and sprint issues, add/move issues to sprints, and access backlog GUI URLs.
- Project & metadata discovery — Browse projects, issue types, priority schemes, labels, and available transitions; resolve names/keys/emails to IDs automatically without requiring pre-lookup calls.
- User & identity management — Look up users by ID, name, or email; list all users; retrieve the authenticated user's profile and available Atlassian Cloud instances.
- Attachment handling — List attachment metadata, download attachment contents, and upload files (string or base64) to issues.
Tools43
Jira_AddCommentToIssue
Add a comment to a Jira issue.
Jira_AddIssuesToSprint
Add a list of issues to a sprint. Maximum of 50 issues per operation.
Jira_AddLabelsToIssue
Add labels to an existing Jira issue.
Jira_AttachFileToIssue
Add an attachment to an issue. Must provide exactly one of file_content_str or file_content_base64.
Jira_CreateIssue
Create a new Jira issue. Provide a value to one of project or parent_issue arguments. If project and parent_issue are not provided, the tool will select the single project available. If the user has multiple, an error will be returned with the available projects to choose from. If you have an issue type name, or a project key/name, a priority name, an assignee name/key/email, or a reporter name/key/email, DO NOT CALL OTHER TOOLS only to list available projects, priorities, issue types, or users. Provide the name, key, or email and the tool will figure out the ID.
Jira_DownloadAttachment
Download the contents of an attachment associated with an issue.
Jira_GetAttachmentMetadata
Get the metadata of an attachment.
Jira_GetAvailableAtlassianClouds
Get available Atlassian Clouds.
Jira_GetBoardBacklogIssues
Get all issues in a board's backlog with pagination support. Returns issues that are not currently assigned to any active sprint. The backlog contains issues that are ready to be planned into future sprints. Only boards that support backlogs (like Scrum and Kanban boards) will return results.
Jira_GetBoards
Retrieve Jira boards either by specifying their names or IDs, or get all available boards. All requests support offset and limit with a maximum of 50 boards returned per call. MANDATORY ACTION: ALWAYS when you need to get multiple boards, you must include all the board identifiers in a single call rather than making multiple separate tool calls, as this provides much better performance, not doing that will bring huge performance penalties. The tool automatically handles mixed identifier types (names and IDs), deduplicates results, and falls back from ID lookup to name lookup when needed.
Jira_GetCommentById
Get a comment by its ID.
Jira_GetIssueById
Get the details of a Jira issue by its ID.
Jira_GetIssueComments
Get the comments of a Jira issue by its ID.
Jira_GetIssuesWithoutId
Search for Jira issues when you don't have the issue ID(s). All text-based arguments (keywords, assignee, project, labels) are case-insensitive. ALWAYS PREFER THIS TOOL OVER A JQL-BASED SEARCH, UNLESS IT'S ABSOLUTELY NECESSARY TO USE A JQL QUERY TO FILTER IN A WAY THAT IS NOT SUPPORTED BY THIS TOOL.
Jira_GetIssueTypeById
Get the details of a Jira issue type by its ID.
Jira_GetPriorityById
Get the details of a priority by its ID.
Jira_GetProjectById
Get the details of a Jira project by its ID or key.
Jira_GetSprintIssues
Get all issues that are currently assigned to a specific sprint with pagination support. Returns issues that are planned for or being worked on in the sprint.
Jira_GetTransitionById
Get a transition by its ID.
Jira_GetTransitionByStatusName
Get a transition available for an issue by the transition name. The response will contain screen fields available for the transition, if any.
Jira_GetTransitionsAvailableForIssue
Get the transitions available for an existing Jira issue.
Jira_GetUserById
Get user information by their ID.
Jira_GetUsersWithoutId
Get users without their account ID, searching by display name and email address. The Jira user search API will return up to 1,000 (one thousand) users for any given name/email query. If you need to get more users, please use the Jira.ListAllUsers tool.
Jira_ListIssueAttachmentsMetadata
Get the metadata about the files attached to an issue. This tool does NOT return the actual file contents. To read a file's content, download the attachment by its ID.
Jira_ListIssues
Get the issues for a given project.
Jira_ListIssueTypesByProject
Get the list of issue types (e.g. 'Task', 'Epic', etc.) available to a given project.
Jira_ListLabels
Get the existing labels (tags) in the user's Jira instance.
Jira_ListPrioritiesAvailableToAnIssue
Browse the priorities available to be used in the specified Jira issue.
Jira_ListPrioritiesAvailableToAProject
Browse the priorities available to be used in issues in the specified Jira project. This tool may need to loop through several API calls to get all priorities associated with a specific project. In Jira environments with too many Projects or Priority Schemes, the search may take too long, and the tool call will timeout.
Jira_ListPrioritiesByScheme
Browse the priorities associated with a priority scheme.
Jira_ListPrioritySchemes
Browse the priority schemes available in Jira.
Jira_ListProjects
Browse projects available in Jira.
Jira_ListProjectsByScheme
Browse the projects associated with a priority scheme.
Jira_ListSprintsForBoards
Retrieve sprints from Jira boards with filtering options for planning and tracking purposes. Use this when you need to view sprints from specific boards or find sprints within specific date ranges. For temporal queries like "last month", "next week", or "this quarter", prioritize date parameters over state filtering. Leave board_identifiers_list as None to get sprints from all available boards. DATE FILTERING PRIORITY: When users request sprints by time periods (e.g., "last month", "next week"), use date parameters (start_date, end_date, specific_date) rather than state filtering, as temporal criteria take precedence over sprint status. Returns sprint data along with a backlog GUI URL link where you can see detailed sprint information and manage sprint items. MANDATORY ACTION: ALWAYS when you need to get sprints from multiple boards, you must include all the board identifiers in a single call rather than making multiple separate tool calls, as this provides much better performance, not doing that will bring huge performance penalties. BOARD LIMIT: Maximum of 25 boards can be processed in a single operation. If you need to process more boards, split the request into multiple batches of 25 or fewer boards each. Handles mixed board identifiers (names and IDs) with automatic fallback and deduplication. All boards are processed concurrently for optimal performance.
Jira_ListUsers
Browse users in Jira.
Jira_MoveIssuesFromSprintToBacklog
Move issues from active or future sprints back to the board's backlog.
Jira_RemoveLabelsFromIssue
Remove labels from an existing Jira issue.
Jira_SearchIssuesWithJql
Search for Jira issues using a JQL (Jira Query Language) query. ONLY USE THIS TOOL WHEN THE FILTER CANNOT BE EXPRESSED WITH STRUCTURED SEARCH PARAMETERS (PROJECT, ASSIGNEE, STATUS, PRIORITY, LABELS, DATES) OR WHEN THE USER PROVIDES A JQL QUERY THEMSELVES.
Jira_SearchIssuesWithoutJql
Parameterized search for Jira issues (without having to provide a JQL query). ALWAYS PREFER THIS TOOL OVER USING JQL, UNLESS IT'S ABSOLUTELY NECESSARY TO USE A JQL QUERY TO FILTER IN A WAY THAT IS NOT SUPPORTED BY THIS TOOL OR IF THE USER PROVIDES A JQL QUERY THEMSELVES.
Jira_SearchProjects
Get the details of all Jira projects.
Jira_TransitionIssueToNewStatus
Transition a Jira issue to a new status.
Jira_UpdateIssue
Update an existing Jira issue. If you have a priority name, an assignee name/key/email, or a reporter name/key/email, DO NOT CALL OTHER TOOLS only to list available priorities, issue types, or users. Provide the name, key, or email and the tool will figure out the ID.
Jira_WhoAmI
CALL THIS TOOL FIRST to establish user profile context. Get information about the currently logged-in user and their available Jira clouds/clients.