George5562 Jira MCP Server

🚀 Jira MCP Server

Interact with Jira in natural language to obtain project information and modify your projects. Combine it with the Claude desktop and create a custom README with project details, enabling you to delegate tasks to project managers (e.g., if you have a list of team members and their expertise, you can assign any new issues to the most relevant person).

This server is built using the Model Context Protocol.

✨ Features

• Project creation and configuration
• Issue and subtask management
• Issue linking and dependencies
• Automated issue workflows

📦 Installation

Configuration

The required environment variables are as follows:

• JIRA_HOST: The hostname of your Jira instance
• JIRA_EMAIL: The email of your Jira account
• JIRA_API_TOKEN: The API token obtained from https://id.atlassian.com/manage-profile/security/api-tokens

💻 Usage Examples

1. User Management

// Get the user's account ID by email
{
  email: "user@example.com";
}

2. Issue Type Management

// List all available issue types
// Returns: id, name, description, subtask status
// No parameters required

3. Issue Link Type

// List all available issue link types
// Returns: id, name, inward/outward description
// No parameters required

4. Issue Management

Get Issues

// Get all issues in a project
{
  projectKey: "PROJECT"
}

// Filter issues using JQL
{
  projectKey: "PROJECT",
  jql: "status = 'In Progress' AND assignee = currentUser()"
}

// Get tasks assigned to a user
{
  projectKey: "PROJECT",
  jql: "assignee = 'user@example.com' ORDER BY created DESC"
}

Create an Issue

// Create a standard issue
{
  projectKey: "PROJECT",
  summary: "Issue title",  // Issue title
  issueType: "Task",       // Or "Story", "Bug", etc.
  description: "Detailed description",  // Description
  assignee: "accountId",    // Account ID obtained from the get_user tool
  labels: ["frontend", "urgent"],  // Labels
  components: ["ui", "api"],      // Components
  priority: "High"              // Priority
}

// Create a subtask
{
  parent: "PROJECT-123",     // Parent issue key
  projectKey: "PROJECT",     // Project key
  summary: "Subtask title",   // Subtask title
  issueType: "Subtask",      // Issue type is Subtask
  description: "Subtask details",
  assignee: "accountId"       // Account ID
}

Update an Issue

// Update issue fields
{
  issueKey: "PROJECT-123",    // Issue key
  summary: "Updated title",   // Updated title
  description: "Updated description",  // Updated description
  assignee: "newAccountId"     // New account ID
}

Delete an Issue

// Delete an issue
{
  issueKey: "PROJECT-123"
}

5. Project Management

Create a Project

{
  name: "New Project",    // Project name
  key: "NEWPROJ"          // Project key
}

Get All Projects

// Get all projects
{
  
}

6. Team Management

Get Team Members

// Get team members
{
  teamId: "TEAM-123"
}

// Returns: an array of members containing accountId and displayName