Jira is Atlassian’s project tracking platform for agile teams. The Jira MCP server lets you create projects, file issues, update tickets, and manage users using natural language.Documentation Index
Fetch the complete documentation index at: https://docs.gumloop.com/llms.txt
Use this file to discover all available pages before exploring further.
What Can It Do?
- Create and manage projects for teams or initiatives
- File, update, and transition issues without opening Jira
- Search with JQL to find issues across your workspace
- Add and download file attachments between issues and Gumloop storage
- Post internal comments on Jira Service Management issues
- Write descriptions and comments in markdown with automatic conversion to Atlassian Document Format (ADF) for rich text rendering
- Manage users and groups for permissions
- Create and manage service desk requests
Where to Use It
In Agents (Recommended)
Add Jira as a tool to any agent. The agent can then manage your development workflow conversationally, choosing the right actions based on context. To add an MCP tool to your agent:- Open your agent’s configuration
- Click Add tools → Connect an app with MCP
- Search for the integration and select it
- Authenticate with your account
In Workflows (Via Agent Node)
For automated pipelines, use an Agent Node with Jira tools. This gives you the flexibility of an agent within a deterministic workflow.As a Custom MCP Node
You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.- Go to your node library and search for the integration
- Click Create a node with AI
- Describe the specific action you want (e.g., “Create a bug in project APP”)
- Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.
Available Tools
| Tool | Description |
|---|---|
| Create Project | Set up a new Jira project |
| Get Project | Retrieve project metadata |
| Update Project | Modify project details |
| Delete Project | Delete a project |
| List Projects | List all accessible projects |
| Create Issue | Create a new issue, bug, or story |
| Get Issue | Retrieve issue details |
| Update Issue | Modify issue fields |
| Delete Issue | Remove an issue |
| Transition My Issue | Move an issue to a new status |
| Search Issues | Search using JQL |
| Comment On Issue | Add a comment (supports internal/private notes for JSM issues and markdown input that is converted to ADF for rich text rendering) |
| Add Attachment | Add a file attachment to an issue from Gumloop storage |
| Download Attachment | Download a file attachment from a Jira issue to Gumloop storage |
| List Fields | List all available fields including custom fields |
| Get Edit Metadata | Get editable fields and allowed values for an issue |
| List Issues | List issues by JQL query |
| Execute JQL | Execute a raw JQL query for advanced searching and filtering |
| Add User To Issue | Add a user as assignee, reporter, or watcher |
| List Users | List all users |
| Add User To Group | Add user to a group |
| Remove User From Group | Remove a user from a group |
| List Groups | List all user groups |
| Create Group | Create a new user group |
| Get Myself | Get info about the authenticated user |
| Get My Issues | Get your assigned issues |
| Get My Recent Activity | View recently updated issues you interacted with |
| Get My Permissions | Check what actions you can perform in a project |
| List Issue Link Types | List available link types (Blocks, Duplicate, Relates, etc.) |
| Create Issue Link | Link two issues together (e.g., blocks, duplicates, relates to) |
| Delete Issue Link | Remove a link between issues |
| Get Issue Links | Get all links for a specific issue |
| List Service Desks | List all Jira Service Management service desks |
| Get Request Types | Get available request types for a service desk |
| Create Customer Request | Create a new customer request in a service desk |
| Get Customer Request | Retrieve a customer request by issue key |
| List Customer Requests | List customer requests from service desks |
| Get Request Type Fields | Get fields required to create a specific request type |
Example Prompts
Use these with your agent or in the Agent Node: Create an issue:Troubleshooting
| Issue | Solution |
|---|---|
| Agent not finding the right data | Use specific issue keys (e.g., APP-234) or project keys |
| Action not completing | Check that you’ve authenticated with Jira |
| Unexpected results | The agent may chain multiple tools (e.g., finding an issue first, then updating). Review the agent’s reasoning to understand its approach. |
| Tool not available | Verify the tool is enabled in your agent’s MCP configuration |
Need Help?
- Agents documentation for setup and best practices
- Agent Node guide for workflow integration
- Gumloop Community for questions and examples
- Contact support@gumloop.com for assistance
Use this integration directly in Claude or Cursor. Connect remotely via the Jira MCP server using your Gumloop credentials.