Navigation
MCP Atlassian Jira Server: Smart Automation & DevOps Optimization - MCP Implementation

MCP Atlassian Jira Server: Smart Automation & DevOps Optimization

Seamlessly bridge Jira workflows with MCP's context-driven automation. Forked from boilerplate, this server optimizes dev ops efficiency for teams hungry for smarter integrations.

Developer Tools
4.1(184 reviews)
276 saves
128 comments

This tool saved users approximately 12751 hours last month!

About MCP Atlassian Jira Server

What is MCP Atlassian Jira Server: Smart Automation & DevOps Optimization?

MCP Atlassian Jira Server is an integration framework enabling AI tools like Claude Desktop and Cursor AI to interact with Atlassian Jira instances via the Model Context Protocol (MCP). This fork of the boilerplate-mcp-server project extends core functionality with Jira-specific APIs, allowing seamless access to project metadata, issue tracking, and DevOps workflows. It bridges the gap between AI-driven automation and Jira's ticket management ecosystem, streamlining DevOps processes through programmable access to Jira's data.

How to Use MCP Atlassian Jira Server: Smart Automation & DevOps Optimization?

Implementation follows three main pathways:

  • AI Tool Integration: Configure credentials in Claude Desktop/Cursor AI settings using either direct command-line parameters or a centralized config file ($HOME/.mcp/configs.json)
  • CLI Interaction: Execute commands like npx -y aashari/mcp-atlassian-jira list-projects to directly query Jira resources
  • Programmatic Access: Developers can leverage the exposed endpoints for custom automation workflows

MCP Atlassian Jira Server Features

Key Features of MCP Atlassian Jira Server: Smart Automation & DevOps Optimization?

  • Granular Jira Access: Full CRUD operations for projects and issues with metadata extraction
  • Query Flexibility: JQL-powered issue filtering and cursor-based pagination for large datasets
  • Contextual Data Retrieval: Returns rich object structures including components, versions, comments, and attachment metadata
  • Secure Authentication: Supports API token-based access with configurable credential storage

Use Cases of MCP Atlassian Jira Server: Smart Automation & DevOps Optimization?

  • Automated status updates for CI/CD pipelines tied to specific Jira tickets
  • Real-time issue prioritization based on machine learning analysis of ticket patterns
  • Self-service ticket creation via chatbots that populate standardized templates
  • Agile sprint reporting tools generating status dashboards from Jira data
  • Compliance audits using automated metadata extraction from historical tickets

MCP Atlassian Jira Server FAQ

FAQ from MCP Atlassian Jira Server: Smart Automation & DevOps Optimization?

  • Q: How do I secure API tokens?
    A: Generate tokens in your Jira account settings under API access configuration, following Atlassian's security best practices.
  • Q: Does pagination work across all endpoints?
    A: Yes, cursor-based pagination is supported for all list operations with --limit and --cursor parameters.
  • Q: Can this handle multi-project environments?
    A: Fully supports querying across multiple projects using JQL project filters and global search capabilities.
  • Q: What authentication methods are available?
    A: Currently supports API token authentication with plans to add OAuth2 support in future releases.
  • Q: Is there rate limiting protection?
    A: Implements adaptive request throttling to prevent Jira API abuse while maintaining operational efficiency.

Content

MCP Atlassian Jira Server

smithery badge

A Model Context Protocol (MCP) server for Atlassian Jira integration. This project allows AI assistants like Claude Desktop and Cursor AI to access and interact with Atlassian Jira content through the Model Context Protocol.

Note : This project is forked from boilerplate-mcp-server, a template for building MCP servers. It maintains compatibility with the boilerplate while adding Jira-specific functionality.

Core Features

This MCP server provides the following capabilities:

Atlassian Jira Integration

  • Projects Management :

    • list-projects: List all available Jira projects with their IDs, keys, names, and URLs (with filtering options)
    • get-project: Get detailed information about a specific Jira project by ID or key, including metadata, components, and versions
  • Issues Management :

    • list-issues: List Jira issues with filtering options by project, status, and more using JQL (Jira Query Language)
    • get-issue: Get detailed information about a specific Jira issue by ID or key, including content, comments, and metadata
  • Pagination Support :

    • Cursor-based pagination for projects and issues listings
    • Seamless navigation through large result sets
    • Clear pagination information in the output with instructions for retrieving the next page
    • Support in both CLI commands and MCP tools

Configuration Options for End Users

Before setting up with Claude Desktop or Cursor AI, you'll need to configure your Atlassian credentials. There are two recommended options for end users:

Option 1: Direct Configuration in Claude/Cursor

Pass your Atlassian credentials directly in the Claude Desktop config or Cursor AI command:

{
  "mcpServers": {
    "aashari/mcp-atlassian-jira": {
      "command": "npx",
      "args": ["-y", "DEBUG=true", "ATLASSIAN_SITE_NAME=your_site_name", "ATLASSIAN_USER_EMAIL=your_email", "ATLASSIAN_API_TOKEN=your_token", "aashari/mcp-atlassian-jira"]
    }
  }
}

Option 2: Global Configuration File (Recommended)

  1. Create a global configuration file at $HOME/.mcp/configs.json:
{
  "@aashari/mcp-atlassian-jira": {
    "environments": {
      "DEBUG": "true",
      "ATLASSIAN_SITE_NAME": "example",
      "ATLASSIAN_USER_EMAIL": "[[email protected]](/cdn-cgi/l/email-protection)",
      "ATLASSIAN_API_TOKEN": "your-atlassian-api-token"
    }
  }
}
  1. Then use a simplified configuration in Claude Desktop or Cursor AI:
{
  "mcpServers": {
    "aashari/mcp-atlassian-jira": {
      "command": "npx",
      "args": ["-y", "aashari/mcp-atlassian-jira"]
    }
  }
}

This approach keeps your credentials in one secure location and simplifies your AI assistant configuration.

Required Configuration

  • ATLASSIAN_SITE_NAME : Your Atlassian site name (e.g., for https://example.atlassian.net, use example).
  • ATLASSIAN_USER_EMAIL : Email address associated with your Atlassian account.
  • ATLASSIAN_API_TOKEN : API token for Atlassian API access (create at Atlassian API tokens).

Optional Configuration

  • DEBUG : Set to true to enable debug logging.

Setting Up with Claude Desktop

To use this MCP server with Claude Desktop:

  1. Open Claude Desktop Settings :
* Launch Claude Desktop
* Click on the settings icon (gear) in the top-right corner

Claude Desktop Settings

  1. Edit MCP Configuration :
* Click on "Edit Config" button
* This will open File Explorer/Finder with the `claude_desktop_config.json` file
  1. Update Configuration File :
* Add one of the configuration options from above to the file
* Save the file

Example with global configuration file already set up:

    {
  "mcpServers": {
    "aashari/mcp-atlassian-jira": {
      "command": "npx",
      "args": ["-y", "aashari/mcp-atlassian-jira"]
    }
  }
}
  1. Restart Claude Desktop :
* Close and reopen Claude Desktop to apply the changes

Claude Desktop Home

  1. Verify Tool Availability :
* On the Claude home page, look for the hammer icon on the right side
* Click it to see available tools
* Ensure the tools are listed

Claude Tools Menu

  1. Test the Tool :
* Try asking Claude to use one of the available tools
* For example: "List all Jira projects" or "Get details about Jira issue with ID PROJ-123"
* Claude will use the MCP tool to fetch and display the requested information

Setting Up with Cursor AI

To use this MCP server with Cursor AI:

  1. Open Cursor Settings :
* Launch Cursor
* Press `CMD + SHIFT + P` (or `CTRL + SHIFT + P` on Windows)
* Type "settings" and select "Cursor Settings"
* On the sidebar, select "MCP"

Cursor Settings MCP

  1. Add New MCP Server :
* Click "+ Add new MCP server"
* A configuration form will appear

Cursor Add MCP Server

  1. Configure MCP Server :
* **Name** : Enter `aashari/mcp-atlassian-jira`
* **Type** : Select `command` from the dropdown
* **Command** : Choose one of the following based on your configuration approach:

If using global configuration file (recommended):

    npx -y aashari/mcp-atlassian-jira

If passing credentials directly:

    DEBUG=true ATLASSIAN_SITE_NAME=your_site_name ATLASSIAN_USER_EMAIL=your_email ATLASSIAN_API_TOKEN=your_token npx -y aashari/mcp-atlassian-jira


* Click "Add"
  1. Verify Server Configuration :
* The server should now be listed with a green indicator
* You should see the available tools listed under the server

Cursor MCP Server Listed

  1. Test the Tool :
* In the chat sidebar, ensure Agent mode is active
* Try asking Cursor AI to use one of the available tools
* For example: "List all Jira projects" or "Get details about Jira issue with ID PROJ-123"
* Cursor AI will use the MCP tool to fetch and display the requested information

Using as a CLI Tool

The package can also be used as a command-line tool for human interaction:

  • Get help and available commands :

    npx -y aashari/mcp-atlassian-jira --help
    

Example output:

    Usage: @aashari/mcp-atlassian-jira [options] [command]

A Model Context Protocol (MCP) server for Atlassian Jira integration

Options:
  -V, --version               output the version number
  -h, --help                  display help for command

Commands:
  list-projects [options]     List Jira projects with optional filtering
  get-project <idOrKey>       Get detailed information about a specific Jira project
  list-issues [options]       List Jira issues with optional filtering
  get-issue <idOrKey>         Get detailed information about a specific Jira issue
  help [command]              display help for command

Projects Commands

  • List Jira projects :

    npx -y aashari/mcp-atlassian-jira list-projects
    

With filtering options:

    npx -y aashari/mcp-atlassian-jira list-projects --query "Marketing" --limit 5

With pagination:

    npx -y aashari/mcp-atlassian-jira list-projects --cursor 5
  • Get project details :

    npx -y aashari/mcp-atlassian-jira get-project PROJ
    

Example output:

    # Project: Marketing Website (PROJ)

**Key**: PROJ
**Name**: Marketing Website
**Type**: Business
**Style**: Next-gen
**Lead**: John Doe

## Description
This project manages all tasks related to our marketing website redesign and maintenance.

## URLs
- **Self**: https://example.atlassian.net/rest/api/3/project/10001
- **Web**: https://example.atlassian.net/browse/PROJ

## Components
1. **Frontend** - Website frontend components
2. **Backend** - API and server components
3. **Content** - Marketing copy and assets

## Versions
1. **v1.0** - Initial Release (Released: 2023-01-15)
2. **v1.1** - Bug fixes (Released: 2023-02-28)
3. **v2.0** - Major redesign (Unreleased)

Issues Commands

  • List Jira issues :

    npx -y aashari/mcp-atlassian-jira list-issues
    

With JQL filtering:

    npx -y aashari/mcp-atlassian-jira list-issues --jql "project = PROJ AND status = 'In Progress'"

With pagination:

    npx -y aashari/mcp-atlassian-jira list-issues --limit 10 --cursor 10
  • Get issue details :

    npx -y aashari/mcp-atlassian-jira get-issue PROJ-123
    

Example output:

    # PROJ-123: Implement new homepage design

**Key**: PROJ-123
**Type**: Task
**Status**: In Progress
**Priority**: Medium
**Assignee**: Jane Smith
**Reporter**: John Doe
**Created**: 2023-03-15T10:30:45.000Z
**Updated**: 2023-03-20T14:22:33.000Z

## Description
We need to implement the new homepage design according to the mockups provided by the design team.

The new design includes:
- Hero section with animated banner
- Product showcase with carousel
- Customer testimonials section
- Updated footer with social media links

## Comments
1. **John Doe** (2023-03-15):
   Initial task creation with requirements

2. **Jane Smith** (2023-03-18):
   Started implementation, hero section complete

## Attachments
- homepage-mockup.png (2.3 MB)
- design-specs.pdf (1.1 MB)

## Links
- **Web**: https://example.atlassian.net/browse/PROJ-123
- **Self**: https://example.atlassian.net/rest/api/3/issue/10123

Development

For information on developing and contributing to this project, please see the DEVELOPMENT.md file.

License

ISC

Author

Andi Ashari

Related MCP Servers & Clients