Project Management

Jira

Integrate Claude Code with Jira to read tickets, implement requirements, and update issue status using MCP or the Jira CLI.

Setup

1.
Install the Jira MCP server or CLI
Claude Code can interact with Jira through an MCP server or by using the Jira CLI. The MCP approach gives Claude Code structured tools for reading and updating issues.
```
claude mcp add jira -- npx -y @anthropic-ai/jira-mcp-server
```
2.
Configure authentication
Set your Jira instance URL, email, and API token. Generate an API token from your Atlassian account settings under Security → API tokens.
```
export JIRA_BASE_URL="https://yourteam.atlassian.net"
export JIRA_EMAIL="you@company.com"
export JIRA_API_TOKEN="your-api-token"
```
3.
Test the connection
Start Claude Code and ask it to fetch a known Jira ticket. This confirms authentication and connectivity are working.
```
claude "read Jira ticket PROJ-123 and summarize the requirements"
```

Features

+Reads Jira tickets including description, acceptance criteria, subtasks, and comments
+Transitions ticket status (To Do → In Progress → In Review → Done)
+Creates subtasks and links related issues during implementation
+Adds work log comments with implementation details and technical decisions
+Searches Jira with JQL to find related tickets and past implementations
+Supports Jira Cloud and Jira Data Center (Server) instances

Use Cases

Ticket-driven development

Give Claude Code a Jira ticket key. It reads the requirements and acceptance criteria, creates a feature branch, implements the work, and transitions the ticket through your workflow states.

Sprint backlog implementation

Ask Claude Code to pull your current sprint's tickets and work through them in priority order, creating a separate branch and PR for each ticket.

Technical debt cleanup

Claude Code reads tech-debt tickets from Jira, analyzes the affected code, performs the refactoring, and documents what changed in the ticket comments.

Cross-referencing bugs

When fixing a bug, Claude Code can search Jira for similar past issues using JQL, learn from previous fixes, and apply patterns that worked before.

Integrating Claude Code with Jira

Jira is the most widely used project management tool in enterprise software development. Claude Code connects to Jira through MCP servers, giving it the ability to read ticket details, update statuses, and add comments — bridging the gap between your project management workflow and AI-assisted coding.

The integration is particularly valuable for teams that enforce strict traceability between Jira tickets and code changes. Claude Code can automatically name branches after ticket keys, include ticket references in commit messages, and update ticket status as work progresses.

Working with Jira workflows

Jira workflows vary widely between teams. Claude Code adapts to your specific workflow by reading available transitions for each ticket. Whether you use a simple To Do → Done flow or a complex workflow with approval stages, Claude Code will only use transitions that are valid for the current ticket state.

Enterprise considerations

For enterprise teams, the Jira MCP server runs locally on the developer's machine. No data is sent to third-party services beyond the Anthropic API. Your Jira API token stays in your local environment, and Claude Code accesses Jira the same way any local CLI tool would.

Does Claude Code support Jira Server (on-premise)?+

Yes. Set the JIRA_BASE_URL to your on-premise Jira instance URL. The MCP server communicates directly with your Jira REST API, whether cloud or self-hosted.

Can Claude Code handle custom Jira fields?+

Yes. The MCP server reads all fields on a ticket, including custom fields. You can instruct Claude Code in your CLAUDE.md to look for specific custom fields like "Story Points" or "Technical Approach."

Is the Jira integration secure for enterprise use?+

The MCP server runs locally and communicates directly with your Jira instance using your API token. Ticket content is sent to the Anthropic API as part of Claude Code's context, so ensure this aligns with your organization's data policies.

Related tools

Claude Code →Amazon Q Developer →

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →

← ALL INTEGRATIONS