jira-cloud-mcp

MCP (Model Context Protocol) server for Jira Cloud integration with Cursor IDE and other MCP-compatible tools.

Features

• Backlog Management: View and manage your backlog issues
• Sprint Support: Get current sprint issues
• Issue Operations: Create, view, comment, and transition issues
• Board Management: List boards and get board info
• Project Listing: View all accessible projects

Installation

npx jira-cloud-mcp

Or install globally:

npm install -g jira-cloud-mcp

Configuration

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | JIRA_HOST | Yes | Your Jira Cloud URL (e.g., https://yourcompany.atlassian.net) | | JIRA_EMAIL | Yes | Your Atlassian account email | | JIRA_API_TOKEN | Yes | API token from Atlassian API Tokens | | JIRA_BOARD_ID | No | Default board ID for backlog/sprint operations | | JIRA_PROJECT_KEY | No | Default project key for creating issues |

Cursor IDE Setup

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-cloud-mcp"],
      "env": {
        "JIRA_HOST": "https://yourcompany.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_BOARD_ID": "123",
        "JIRA_PROJECT_KEY": "PROJ"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | get_backlog | Get all issues in the backlog | | get_sprint_issues | Get issues in the current active sprint | | get_issue | Get detailed information about a specific issue | | get_issue_comments | Get comments for a specific issue | | add_comment | Add a comment to an issue | | transition_issue | Move an issue to a different status | | create_issue | Create a new issue | | list_projects | List all accessible Jira projects | | get_board_info | Get information about the configured board | | list_boards | List all accessible Jira boards |

Usage Examples

Once configured, you can ask your AI assistant:

• "Show me the backlog"
• "What's in the current sprint?"
• "Get details for issue PROJ-123"
• "Move PROJ-123 to In Progress"
• "Create a new bug: Login button not working"
• "Add a comment to PROJ-123: Fixed in latest commit"

License

MIT

Author

Suat Karabacak