MCP Jira Python

🚀 MCP JIRA Python

A Python implementation of an MCP server for JIRA integration. MCP is a communication protocol designed to provide tools for your AI and protect your data security (it can also remain localized if needed). This server runs on the same computer as your AI application, and Claude Desktop is the first application to run the MCP server (and it's also the client. Check out the simple Python MCP client in the examples folder).

🚀 Quick Start

📦 Installation

# Install the server locally
git clone https://github.com/kallows/mcp-jira-python.git 

✨ Features

This MCP server offers the following JIRA integration tools:

• delete_issue: Delete a Jira issue or subtask using the issue key.
• create_jira_issue: Create a new Jira issue, supporting custom fields including title, description, type, priority, and assignee.
• get_issue: Get the full issue details, including comments and attachments, for a given issue key.
• create_issue_link: Create relationships between issues (e.g., "Blocks", "Is blocked by", etc.).
• update_issue: Update an existing issue, setting new field values such as title, description, status, priority, or assignee.
• get_user: Find a user's account ID using their email address.
• list_fields: Get a list of all available fields and their attributes in JIRA.
• list_issue_types: Retrieve all available issue types in your JIRA instance.
• list_link_types: Get all possible relationship types for issue links.
• search_issues: Search for issues in a specific project using JQL (JIRA Query Language).
• add_comment: Add a text comment to an existing issue.
• add_comment_with_attachment: Add a comment to an issue with an attachment.

💻 Usage Examples

Claude Desktop Configuration

This requires you to update the claude_desktop_config.json. The location of the file varies depending on whether you're using Apple, Windows, or Linux.

Windows

⚠️ Important Note

In Windows, the path to claude_desktop_config.json is:

%AppData%\\Claude\\claude_desktop_config.json

This usually resolves to: C:\\Users\\YOURUSERNAME\\AppData\\Roaming\\Claude

Here is the configuration block that needs to be added to claude_desktop_config.json. On Windows, we always use the full path. You'll update the "command", set your directory path, and add the JIRA environment settings.

    "jira-api": {
      "command": "C:\\\\Users\\\\YOURUSERNAME\\\\.local\\\\bin\\\\uv.exe",
      "args": [
        "--directory",
        "D:\\\\mcp\\\\mcp-jira-python",
        "run",
        "-m",
        "mcp_jira_python.server"
      ],
      "env": {
        "JIRA_HOST": "YOURNAME.atlassian.net",
        "JIRA_EMAIL": "yourname@example.com",
        "JIRA_API_TOKEN": "YOURJIRATOKEN"
      }      
    }

⚠️ Important Note

You must close Claude Desktop AND terminate all Claude processes to enable the updated claude_desktop_config.json!

Mac/Linux

Add the following to claude_desktop_config.json:

    "jira-api": {
      "command": "python3",
      "args": [
        "-m",
        "mcp_jira_python.server"
      ],
      "env": {
        "JIRA_HOST": "YOURNAME.atlassian.net",
        "JIRA_EMAIL": "yourname@example.com",
        "JIRA_API_TOKEN": "YOURJIRATOKEN"
      }      
    }

Also, you need to run the following in the terminal:

python3 -m mcp_jira_python.server

📚 Documentation

Project Structure

MCP-JIRA-Python/
├── src/
│   └── jira_api/
│       ├── __init__.py
│       └── server.py
└── tests/
    ├── __init__.py
    ├── test_jira_api.py
    ├── test_jira_integration.py
    └── test_jira_mcp_system.py