MCP JIRA Server

MCP Jira Integration

A simple Model Context Protocol (MCP) server for Jira that allows LLMs to act as project managers and personal assistants for teams using Jira.

Features

Core MCP Tools

create_issue - Create new Jira issues with proper formatting
search_issues - Search issues using JQL with smart formatting
get_sprint_status - Get comprehensive sprint progress reports
get_team_workload - Analyze team member workloads and capacity
generate_standup_report - Generate daily standup reports automatically

Project Management Capabilities

Sprint progress tracking with visual indicators
Team workload analysis and capacity planning
Automated daily standup report generation
Issue creation with proper prioritization
Smart search and filtering of issues

Requirements

Python 3.8 or higher
Jira account with API token
MCP-compatible client (like Claude Desktop)

Quick Setup

Clone and install:

cd mcp-jira-implementation/mcp-jira
pip install -e .

Configure Jira credentials in .env:

JIRA_URL=https://your-domain.atlassian.net
JIRA_USERNAME=your.email@domain.com
JIRA_API_TOKEN=your_api_token
PROJECT_KEY=PROJ
DEFAULT_BOARD_ID=123

Run the MCP server:

python -m mcp_jira.simple_mcp_server

Usage Examples

Creating Issues

"Create a high priority bug for the login system not working properly"

Auto-assigns proper issue type, priority, and formatting

Sprint Management

"What's our current sprint status?"

Gets comprehensive progress report with metrics and visual indicators

Team Management

"Show me the team workload for john.doe, jane.smith, mike.wilson"

Analyzes capacity and provides workload distribution

Daily Standups

"Generate today's standup report"

Creates formatted report with completed, in-progress, and blocked items

MCP Integration

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-jira": {
      "command": "python",
      "args": ["-m", "mcp_jira.simple_mcp_server"],
      "cwd": "/path/to/mcp-jira"
    }
  }
}

With Other MCP Clients

The server follows the standard MCP protocol and works with any MCP-compatible client.

Configuration

Required Environment Variables

JIRA_URL - Your Jira instance URL
JIRA_USERNAME - Your Jira username/email
JIRA_API_TOKEN - Your Jira API token
PROJECT_KEY - Default project key for operations

Optional Settings

DEFAULT_BOARD_ID - Default board for sprint operations
DEBUG_MODE - Enable debug logging (default: false)
LOG_LEVEL - Logging level (default: INFO)

Getting Jira API Token

Go to Atlassian Account Settings
Click "Create API token"
Give it a name and copy the token
Use your email as username and the token as password

Architecture

This implementation prioritizes simplicity:

Single MCP server file - All tools in one place
Standard MCP protocol - Uses official MCP SDK
Rich formatting - Provides beautiful, readable reports
Error handling - Graceful handling of Jira API issues
Async support - Fast and responsive operations

Troubleshooting

Common Issues

"No active sprint found"
- Make sure your board has an active sprint
- Check that DEFAULT_BOARD_ID is set correctly
Authentication errors
- Verify your API token is correct
- Check that your username is your email address
Permission errors
- Ensure your Jira user has appropriate project permissions
- Check that the project key exists and you have access

Debug Mode

Set DEBUG_MODE=true in your .env file for detailed logging.

Contributing

Fork the repository
Make your changes
Test with your Jira instance
Submit a pull request

License

MIT License - see LICENSE file

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables AI applications to manage JIRA issues, workflows, and tasks through a standardized MCP interface, facilitating real-time updates and seamless interaction with JIRA's API.

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-jira-server
1broseidon
A
security
F
license
A
quality
Provides integration with Jira's REST API, allowing AI assistants to manage Jira issues programmatically.
Last updated -
6
6
JavaScript
JIRA MCP Server
cosmix
A
security
A
license
A
quality
Provides an interface to access and manage JIRA data through the Model Context Protocol, offering features like relationship tracking, data cleaning, and contextual insights for AI applications.
Last updated -
9
146
18
TypeScript
MIT License
Jira MCP Server
uddeshya-23
-
security
F
license
-
quality
Enables AI models to interact with Jira using a standardized protocol, offering full Jira REST API integration with features like optimal performance through connection pooling, error handling, and request monitoring.
Last updated -
2
TypeScript
MCP Atlassian
samwang0723
-
security
F
license
-
quality
An MCP server that enables AI agents to interact with Atlassian products (Confluence and Jira) for content management, issue tracking, and project management through a standardized interface.
Last updated -
2
TypeScript

View all related MCP servers