@abdelrahmanhsn/jira-mcp

A Model Context Protocol (MCP) server that connects your AI IDE to Jira. Query tickets, manage sprints, and let AI autonomously implement, test, and ship Jira tickets — all without leaving your editor.

Works with GitHub Copilot, Cursor, Claude Desktop, and any MCP-compatible client.

Tools

| Tool | Description | |------|-------------| | get_my_tickets | Get all Jira tickets assigned to you, ordered by last updated | | get_active_sprint_tickets | Get your tickets in the currently active sprint | | get_issue_details | Get full details (description + attachments) for a specific issue key | | add_comment | Add a comment to any Jira issue | | get_my_standup | Get a standup summary of tickets you updated since yesterday | | get_sprint_summary | Get all sprint tickets grouped by status (Todo / In Progress / Done) | | search_tickets | Search tickets with plain English or raw JQL | | get_context_for_pr | Extract Jira ticket from a branch name and return a ready-to-use PR description block | | start_ticket | 🤖 Autonomous mode — assigns ticket, moves to In Progress, creates git branch, then drives AI to implement, test, commit, push, open PR, and comment on Jira — non-stop |

Prerequisites

• Node.js 18 or later
• A Jira Cloud account
• A Jira API token (generate one here)
• GitHub CLI — required for start_ticket to create PRs automatically

Install GitHub CLI

# macOS
brew install gh
gh auth login

# Windows
winget install --id GitHub.cli
gh auth login

# Linux
# See https://github.com/cli/cli/blob/trunk/docs/install_linux.md
gh auth login

If gh is not installed or not authenticated, start_ticket will return clear instructions instead of silently failing.

Setup

1. Get your Jira API token

1. Go to https://id.atlassian.com/manage-profile/security/api-tokens
2. Click Create API token
3. Copy the token — you'll need it below

2. Configure your MCP client

✨ The easiest way (Web Setup UI): Simply add the server to your MCP config without any environment variables. When the MCP server starts, it will automatically launch an interactive web UI in your browser (http://localhost:9898). You can enter your Jira credentials there, and it will securely save them directly into your AI IDE's local configuration file and seamlessly start the MCP server!

Supported auto-save clients: VS Code, Cursor, Claude Desktop, and Antigravity.

Or, configure it manually:

Pick your AI IDE below and add the config. Replace the env values with your own.

GitHub Copilot (VS Code)

Open User Settings (JSON) via Cmd+Shift+P → Open User Settings (JSON) and add:

"mcp": {
  "servers": {
    "jira-mcp": {
      "command": "npx",
      "args": ["-y", "@abdelrahmanhsn/jira-mcp"],
      "env": {
        "JIRA_EMAIL": "[email protected]",
        "JIRA_TOKEN": "your-api-token",
        "JIRA_DOMAIN": "yourcompany.atlassian.net",
        "JIRA_PROJECT": "PROJ"
      }
    }
  }
}

Cursor

Open ~/.cursor/mcp.json (or Cursor Settings → MCP) and add:

{
  "mcpServers": {
    "jira-mcp": {
      "command": "npx",
      "args": ["-y", "@abdelrahmanhsn/jira-mcp"],
      "env": {
        "JIRA_EMAIL": "[email protected]",
        "JIRA_TOKEN": "your-api-token",
        "JIRA_DOMAIN": "yourcompany.atlassian.net",
        "JIRA_PROJECT": "PROJ"
      }
    }
  }
}

Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json and add:

{
  "mcpServers": {
    "jira-mcp": {
      "command": "npx",
      "args": ["-y", "@abdelrahmanhsn/jira-mcp"],
      "env": {
        "JIRA_EMAIL": "[email protected]",
        "JIRA_TOKEN": "your-api-token",
        "JIRA_DOMAIN": "yourcompany.atlassian.net",
        "JIRA_PROJECT": "PROJ"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | JIRA_EMAIL | ✅ | Your Jira account email | | JIRA_TOKEN | ✅ | Your Jira API token | | JIRA_DOMAIN | ✅ | Your Jira domain, e.g. yourcompany.atlassian.net | | JIRA_PROJECT | ✅ | Your Jira project key, e.g. PROJ |

Usage Examples

Everyday queries

• "Show me my current Jira tickets"
• "What's in my active sprint?"
• "Get me the details for PROJ-1234"
• "Add a comment to PROJ-123 saying the fix is deployed to staging"
• "Give me my standup for today"
• "Summarize the active sprint — how many tickets are done vs in progress?"
• "Search for open bugs related to login"

PR workflow

• "Get PR context for branch STUD-17891-add-email-icon" → Extracts the ticket key from the branch, fetches description + comments, returns a formatted PR description block ready to paste or expand.

Autonomous mode — start_ticket

The most powerful tool. One prompt and AI does everything:

"Start working on STUD-17931"

What happens automatically, with no stops:

1. ✅ Self-assigns the Jira ticket to you
2. ✅ Moves it to In Progress
3. ✅ Creates and switches to a git branch (e.g. stud-17931-content-preview-bug)
4. ✅ AI reads description, acceptance criteria, and comments
5. ✅ Implements the feature/fix
6. ✅ Runs the test suite — fixes failures automatically
7. ✅ Commits and pushes the branch
8. ✅ Opens a PR via gh pr create
9. ✅ Posts the PR link as a comment on the Jira ticket

You can optionally pass the repo path:

"Start working on STUD-17931 in /Users/you/code/my-project"

If omitted, the tool auto-detects the git repo from the current working directory.

Security

• Credentials are never stored in code — they are injected at runtime by your MCP client
• Each user provides their own credentials in their local MCP config
• Your API token is only sent to your own Jira domain over HTTPS

License

ISC