Jira
A connector to the Jira software.
What you can ask
- Find every Jira issue assigned to me with status
In progressand a due date in the past. - Create a sub-task under PROJ-1247 for each acceptance criterion in this story.
- Move all stale
In reviewtickets older than 14 days intoBacklog.
Set up
Jira needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.
- Go to Organization > Connectors and find Jira. Click Enable, and choose which tools to allow.
- In the Atlassian developer console, choose Create, then OAuth 2.0 integration, and name the app after your organization.
- Under Permissions, add the Jira API and grant these scopes: View Jira issue data, Manage project settings, Manage Jira global settings, View user profiles, and Create and manage issues. Atlassian rejects the consent screen if scopes are missing.
- Under Distribution, set the status to Sharing, use your own name as the vendor, fill in the privacy policy, terms of service, and support contact, and set Personal data declaration to No.
- Under Authorization, configure OAuth 2.0 (3LO) with the exact callback URL shown in the connector settings.
- Copy the client ID and secret from the app's Settings page into the connector, then save it.
- Each member connects their own account the first time they use it.
⚠️ Warning: Do not enter your Devs.ai or Jira login email or password in the OAuth application fields.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
OAuth scopes used by these tools (11)
Grant the scopes for the tools you plan to allow.
manage:jira-configurationmanage:jira-projectread:board-scope:jira-softwareread:issue-details:jiraread:jira-userread:jira-workread:project:jiraread:sprint:jira-softwarewrite:board-scope:jira-softwarewrite:jira-workwrite:sprint:jira-software
Tools
Jira offers 48 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (30)
View and search information without changing it.
| Tool | What it does |
|---|---|
discover_issue_required_fields | Discover required fields for Jira issue creation. |
get_active_sprint | Get the active sprint for a Jira project by project key. |
get_attachment_content | Read a Jira attachment: content_base64, plus extracted_text for PDF, DOCX and text files (logs, stack traces); check extraction_status. |
get_attachment_thumbnail | Get the small preview Jira generates for an image attachment, as content_base64. |
get_board | Get Jira board details. |
get_board_sprints | List sprints for board. |
get_boards | List all Jira boards. |
get_comments | Get comments for a Jira issue |
get_current_user | Get the current authenticated user |
get_issue | Get Jira issue details using the issue key |
get_issue_attachments | List an issue's attachments: attachment ID, filename, size, MIME type, author, created date. |
get_issue_transitions | Get available transitions for a Jira issue |
get_move_task_progress | Check progress of bulk move operation. |
get_priorities | Get all available priorities. |
get_project | Get a specific Jira project by key or ID |
get_project_components | Get all components for a Jira project. |
get_project_issue_types | Get issue types for a specific project |
get_project_statuses | Get workflow statuses available for a specific project. |
get_project_templates | Get template keys for project type. |
get_project_versions | Get versions for a specific project |
get_projects | Search and filter Jira projects. |
get_sprint | Get sprint details. |
get_user | Get a specific Jira user by account ID or username |
get_user_assignee_suggestions | Get user assignee suggestions for an issue or project |
get_user_groups | Get groups that a user belongs to |
get_worklogs | Get worklog entries for a Jira issue |
list_statuses | List all workflow statuses in Jira. |
search_issues | Search Jira issues using JQL or structured filters. |
search_users | Search for Jira users. |
validate_credential | Validate Jira credentials. |
Write (7)
Create or send data.
| Tool | What it does |
|---|---|
add_attachment | Add an attachment to a Jira issue. |
add_comment | Add a comment to a Jira issue. |
add_worklog | Log work on a Jira issue. |
create_board | Create Jira board (scrum/kanban). |
create_issue | Create a Jira issue. |
create_project | Create Jira project. |
link_issues | Link two Jira issues. |
Delete or overwrite (11)
Remove or replace existing data.
| Tool | What it does |
|---|---|
delete_attachment | Delete an attachment by ID. |
delete_comment | Delete a comment from a Jira issue |
delete_issue | Delete a Jira issue |
delete_project | Delete a Jira project. |
move_issues_between_projects | Move issues between projects. |
move_issues_to_backlog | Move issues to backlog. |
move_issues_to_sprint | Move issues to sprint. |
transition_issue | Transition a Jira issue to a new status. |
update_comment | Replace the body of an existing Jira comment. |
update_issue | Update a Jira issue. |
update_project | Update a Jira project. |