Jira Automation Agent Skill

Jira Automation via Rube MCP

Automate Jira operations through Composio's Jira toolkit via Rube MCP.

Toolkit docs: composio.dev/toolkits/jira

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
• Active Jira connection via RUBE_MANAGE_CONNECTIONS with toolkit jira
• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

• Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds
• Call RUBE_MANAGE_CONNECTIONS with toolkit jira
• If connection is not ACTIVE, follow the returned auth link to complete Jira OAuth
• Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Search and Filter Issues

When to use: User wants to find issues using JQL or browse project issues

Tool sequence:

• JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST - Search with JQL query [Required]
• JIRA_GET_ISSUE - Get full details of a specific issue [Optional]

Key parameters:

• jql: JQL query string (e.g., project = PROJ AND status = "In Progress")
• maxResults: Max results per page (default 50, max 100)
• startAt: Pagination offset
• fields: Array of field names to return
• issueIdOrKey: Issue key like 'PROJ-123' for GET_ISSUE

Pitfalls:

• JQL field names are case-sensitive and must match Jira configuration
• Custom fields use IDs like customfield_10001, not display names
• Results are paginated; check total vs startAt + maxResults to continue

2. Create and Edit Issues

When to use: User wants to create new issues or update existing ones

Tool sequence:

• JIRA_GET_ALL_PROJECTS - List projects to find project key [Prerequisite]
• JIRA_GET_FIELDS - Get available fields and their IDs [Prerequisite]
• JIRA_CREATE_ISSUE - Create a new issue [Required]
• JIRA_EDIT_ISSUE - Update fields on an existing issue [Optional]
• JIRA_ASSIGN_ISSUE - Assign issue to a user [Optional]

Key parameters:

• project: Project key (e.g., 'PROJ')
• issuetype: Issue type name (e.g., 'Bug', 'Story', 'Task')
• summary: Issue title
• description: Issue description (Atlassian Document Format or plain text)
• issueIdOrKey: Issue key for edits

Pitfalls:

• Issue types and required fields vary by project; use GET_FIELDS to check
• Custom fields require exact field IDs, not display names
• Description may need Atlassian Document Format (ADF) for rich content

3. Manage Sprints and Boards

When to use: User wants to work with agile boards, sprints, and backlogs

Tool sequence:

• JIRA_LIST_BOARDS - List all boards [Prerequisite]
• JIRA_LIST_SPRINTS - List sprints for a board [Required]
• JIRA_MOVE_ISSUE_TO_SPRINT - Move issue to a sprint [Optional]
• JIRA_CREATE_SPRINT - Create a new sprint [Optional]

Key parameters:

• boardId: Board ID from LIST_BOARDS
• sprintId: Sprint ID for move operations
• name: Sprint name for creation
• startDate/endDate: Sprint dates in ISO format

Pitfalls:

• Boards and sprints are specific to Jira Software (not Jira Core)
• Only one sprint can be active at a time per board

4. Manage Comments

When to use: User wants to add or view comments on issues

Tool sequence:

• JIRA_LIST_ISSUE_COMMENTS - List existing comments [Optional]
• JIRA_ADD_COMMENT - Add a comment to an issue [Required]

Key parameters:

• issueIdOrKey: Issue key like 'PROJ-123'
• body: Comment body (supports ADF for rich text)

Pitfalls:

• Comments support ADF (Atlassian Document Format) for formatting
• Mentions use account IDs, not usernames

5. Manage Projects and Users

When to use: User wants to list projects, find users, or manage project roles

Tool sequence:

• JIRA_GET_ALL_PROJECTS - List all projects [Optional]
• JIRA_GET_PROJECT - Get project details [Optional]
• JIRA_FIND_USERS / JIRA_GET_ALL_USERS - Search for users [Optional]
• JIRA_GET_PROJECT_ROLES - List project roles [Optional]
• JIRA_ADD_USERS_TO_PROJECT_ROLE - Add user to role [Optional]

Key parameters:

• projectIdOrKey: Project key
• query: Search text for FIND_USERS
• roleId: Role ID for role operations

Pitfalls:

• User operations use account IDs (not email or display name)
• Project roles differ from global permissions

Common Patterns

JQL Syntax

Common operators:

• project = "PROJ" - Filter by project
• status = "In Progress" - Filter by status
• assignee = currentUser() - Current user's issues
• created >= -7d - Created in last 7 days
• labels = "bug" - Filter by label
• priority = High - Filter by priority
• ORDER BY created DESC - Sort results

Combinators:

• AND - Both conditions
• OR - Either condition
• NOT - Negate condition

Pagination

• Use startAt and maxResults parameters
• Check total in response to determine remaining pages
• Continue until startAt + maxResults >= total

Known Pitfalls

Field Names:

• Custom fields use IDs like customfield_10001
• Use JIRA_GET_FIELDS to discover field IDs and names
• Field names in JQL may differ from API field names

Authentication:

• Jira Cloud uses account IDs, not usernames
• Site URL must be configured correctly in the connection

Quick Reference

| Task | Tool Slug | Key Params |

|------|-----------|------------|

| Search issues (JQL) | JIRA_SEARCH_FOR_ISSUES_USING_JQL_POST | jql, maxResults |

| Get issue | JIRA_GET_ISSUE | issueIdOrKey |

| Create issue | JIRA_CREATE_ISSUE | project, issuetype, summary |

| Edit issue | JIRA_EDIT_ISSUE | issueIdOrKey, fields |

| Assign issue | JIRA_ASSIGN_ISSUE | issueIdOrKey, accountId |

| Add comment | JIRA_ADD_COMMENT | issueIdOrKey, body |

| List comments | JIRA_LIST_ISSUE_COMMENTS | issueIdOrKey |

| List projects | JIRA_GET_ALL_PROJECTS | (none) |

| Get project | JIRA_GET_PROJECT | projectIdOrKey |

| List boards | JIRA_LIST_BOARDS | (none) |

| List sprints | JIRA_LIST_SPRINTS | boardId |

| Move to sprint | JIRA_MOVE_ISSUE_TO_SPRINT | sprintId, issues |

| Create sprint | JIRA_CREATE_SPRINT | name, boardId |

| Find users | JIRA_FIND_USERS | query |

| Get fields | JIRA_GET_FIELDS | (none) |

| List filters | JIRA_LIST_FILTERS | (none) |

| Project roles | JIRA_GET_PROJECT_ROLES | projectIdOrKey |

| Project versions | JIRA_GET_PROJECT_VERSIONS | projectIdOrKey |

*Powered by Composio*