Skip to main content
Glama
deenesjakoruzh

MCP JIRA Server

by Warzuponus
GitHub
Python
MIT License
6
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

  1. Clone and install:

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

  1. 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

  1. 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

  1. Go to Atlassian Account Settings

  2. Click "Create API token"

  3. Give it a name and copy the token

  4. 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

  1. "No active sprint found"

    • Make sure your board has an active sprint

    • Check that DEFAULT_BOARD_ID is set correctly

  2. Authentication errors

    • Verify your API token is correct

    • Check that your username is your email address

  3. 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

  1. Fork the repository

  2. Make your changes

  3. Test with your Jira instance

  4. Submit a pull request

License

MIT License - see LICENSE file

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

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.

  1. Features
    1. Core MCP Tools
    2. Project Management Capabilities
  2. Requirements
    1. Quick Setup
      1. Usage Examples
        1. Creating Issues
        2. Sprint Management
        3. Team Management
        4. Daily Standups
      2. MCP Integration
        1. With Claude Desktop
        2. With Other MCP Clients
      3. Configuration
        1. Required Environment Variables
        2. Optional Settings
      4. Getting Jira API Token
        1. Architecture
          1. Troubleshooting
            1. Common Issues
            2. Debug Mode
          2. Contributing
            1. License

              Related Resources

              Related MCP Servers

              • mcp-jira-server

                1broseidon
                A
                security
                A
                license
                A
                quality
                Provides integration with Jira's REST API, allowing AI assistants to manage Jira issues programmatically.
                Last updated -
                8
                9
                MIT License
                • Apple

              • 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
                93
                21
                MIT License
                • Apple
                • Linux

              • Jira MCP Server

                brianstone
                A
                security
                A
                license
                A
                quality
                An MCP server that enables communication with Jira, allowing users to perform operations like getting, searching, creating, and editing issues through natural language interaction.
                Last updated -
                1
                15
                MIT License

              • Personal JIRA MCP

                yuezheng2006
                A
                security
                A
                license
                A
                quality
                An MCP server that enables AI assistants to interact with JIRA, allowing for querying issue details, creating and updating work items, and managing attachments through a standardized interface.
                Last updated -
                12
                1
                MIT License
                • Linux
                • Apple

              View all related MCP servers

              Appeared in Searches

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/Warzuponus/mcp-jira'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server