Overview
The Jira toolset enables AI agents to interact with your Jira workspace. Agents can create issues, search tickets, add comments, update issues, and more. This toolset is ideal for automating project management workflows and integrating Jira into conversational AI experiences.Key Capabilities
- Create and manage issues - Create new tickets, update existing ones, change status
- Search with JQL - Find issues using Jira Query Language
- Comment management - Add and retrieve comments on issues
- Project operations - List projects, get project metadata
- User operations - Search users, get current user info
Available Tools
| Tool | Description | Type |
|---|---|---|
create_issue | Create a new Jira issue | Action |
update_issue | Update an existing issue (summary, description, status, assignee, etc.) | Action |
get_issue | Get details of a specific issue | Search |
get_issues | Get issues from a project | Search |
search_issues | Search issues using JQL queries | Search |
add_comment | Add a comment to an issue | Action |
get_comments | Get comments for an issue | Search |
get_projects | Get all Jira projects | Search |
get_project | Get details of a specific project | Search |
get_project_metadata | Get project metadata (issue types, components) | Search |
search_users | Search users by name or email | Search |
get_current_user | Get current authenticated user info | Search |
validate_connection | Validate Jira connection status | Utility |
convert_text_to_adf | Convert plain text to Atlassian Document Format | Utility |
Configuration Guide
Setup
Setup
Step 1: Access Atlassian Developer Console
- Navigate to developer.atlassian.com/console/myapps/
- Sign in with your Atlassian account
Step 2: Create OAuth 2.0 Integration
- Click “Create” in the top right corner
- Select “OAuth 2.0 integration”
- Enter a name (e.g., “PipesHub Jira Toolset”)
- Click “Create”
Step 3: Get Redirect URI from PipesHub
- In PipesHub, go to Settings > Toolsets
- Find Jira and click “Configure”
- Copy the Redirect URI shown in the dialog
Step 4: Configure Callback URL
- In Atlassian Developer Console, go to Authorization
- Click “Add” under OAuth 2.0 (3LO)
- Paste the Redirect URI from PipesHub into the Callback URL field
- Click “Save changes”
Step 5: Add Required Scopes
- In the left sidebar, click “Permissions”
- Add scopes for both User identity API and Jira API
User Identity API
Click “Add” next to User identity API and select:| Scope | Description |
|---|---|
read:account | View user profiles (required for user identification) |
Jira API - Classic Scopes
Click “Add” next to Jira API. You’ll see two tabs: “Classic scopes” and “Granular scopes”. Add scopes from both tabs.First, select the “Classic scopes” tab and add:| Scope | Description |
|---|---|
read:jira-work | Read Jira project and issue data |
write:jira-work | Create and update issues, add comments |
read:jira-user | Read user information |
Jira API - Granular Scopes
Next, select the “Granular scopes” tab and add:| Scope | Description |
|---|---|
read:user:jira | View user details |
read:group:jira | View groups and group members |
read:avatar:jira | View user and project avatars |
read:audit-log:jira | Read audit logs |
read:application-role:jira | Read application roles |
read:project-role:jira | Read project roles and role assignments |
Step 6: Get OAuth Credentials
- In the left sidebar, click “Settings”
- Under “Authentication details”, copy:
- Client ID
- Secret (click the copy button)
Step 7: Configure in PipesHub
- Return to the PipesHub Jira toolset configuration dialog
- Enter your Client ID and Client Secret
- Click “Save Configuration”
Step 8: Authorize Access
- A popup window will open to Atlassian’s authorization page
- Select your Jira site from the dropdown
- Review the permissions and click “Accept”
- You’ll be redirected back to PipesHub
- The toolset will show “Authenticated” status
FAQ
What's the difference between Jira Connector and Jira Toolset?
What's the difference between Jira Connector and Jira Toolset?
| Aspect | Jira Connector | Jira Toolset |
|---|---|---|
| Purpose | Sync and index Jira data for search | Enable agents to perform actions in Jira |
| Data Flow | One-way (import data into PipesHub) | Two-way (read and write via API) |
| When to Use | Query/search issues, projects, comments | Create issues, update tickets, add comments |
When searching issues, always include a time range (e.g., “from the last 30 days” or “updated this week”) to get accurate results.
Usage Tips
How do I create an issue?Simply ask your agent to “create a Jira ticket” and provide the project key, title, and issue type (Task, Bug, or Story). You can also specify assignee, priority, and labels. How do I search for issues?
Ask to “find Jira issues” with specific criteria. The agent will use JQL syntax automatically. For example: “show me all in-progress issues in project PA from the last week” How do I assign issues?
You can assign by name (e.g., “assign to John Smith”) or by email. The agent will look up the correct account ID automatically. How do I update issue status?
Ask to “move issue PA-123 to In Progress” or “mark PA-456 as Done”. Common statuses include “To Do”, “In Progress”, and “Done”.