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