jira-mcp-server

Jira MCP Server

A Model Context Protocol (MCP) server for Jira integration. This server allows AI assistants like Claude to interact with Jira using MCP.

Author: Samuel Rizzo

Features

• List all Jira projects
• Get detailed issue information
• Search issues by project and assignee
• List project members
• Check user's project membership and assigned issues
• Create new issues with custom fields
• List and query sprints with filtering options

Installation

# Clone the repository
git clone https://github.com/samuelrizzo/jira-mcp-server.git
cd jira-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Configuration

MCP Server Configuration

Add the following configuration to your cursor/windsurf mcp settings file:

{
  "mcpServers": {
    "jira-mcp": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Setting up API Access

1. Generate a Jira API token:

   • Go to Atlassian Account Settings
   • Click "Create API Token"
   • Give it a name and click "Create"
   • Copy the token (you'll need it for authentication)

2. Note your Jira host URL (e.g., your-domain.atlassian.net) and email address associated with your Atlassian account.

3. Add these credentials to your MCP server configuration.

Available Tools

1. List Projects (mcp_jira_list_projects)

Lists all Jira projects the authenticated user has access to.

Parameters:

• jiraHost: Your Jira domain (e.g., 'your-domain.atlassian.net')
• email: Your Jira email
• apiToken: Your Jira API token

2. Get Issue Details (mcp_jira_get_issue)

Retrieves detailed information about a specific Jira issue.

Parameters:

• issueKey: The Jira issue key (e.g., 'PROJECT-123')
• jiraHost: Your Jira domain
• email: Your Jira email
• apiToken: Your Jira API token

3. Search Issues (mcp_jira_search_issues)

Searches for issues in a specific project, optionally filtered by assignee.

Parameters:

• projectKey: The Jira project key
• assigneeName: (Optional) Filter issues by assignee name
• jiraHost: Your Jira domain
• email: Your Jira email
• apiToken: Your Jira API token

4. List Project Members (mcp_jira_list_project_members)

Lists all members of a specific Jira project.

Parameters:

• projectKey: The Jira project key
• jiraHost: Your Jira domain
• email: Your Jira email
• apiToken: Your Jira API token

5. Check User Issues (mcp_jira_check_user_issues)

Checks if a user is a member of a project and lists their assigned issues.

Parameters:

• projectKey: The Jira project key
• userName: The display name of the user to check
• jiraHost: Your Jira domain
• email: Your Jira email
• apiToken: Your Jira API token

6. Create Issue (mcp_jira_create_issue)

Creates a new issue in a Jira project with specified details.

Parameters:

• projectKey: The Jira project key
• summary: The title/summary of the issue
• description: Detailed description of the issue
• issueType: (Optional) Type of issue (e.g., 'Task', 'Bug', 'Story'), defaults to 'Task'
• assigneeName: (Optional) The display name of the person to assign the issue to
• reporterName: (Optional) The display name of the person reporting the issue
• sprintId: (Optional) ID of the sprint to add the issue to
• jiraHost: Your Jira domain
• email: Your Jira email
• apiToken: Your Jira API token

7. List Sprints (mcp_jira_list_sprints)

Lists current sprints in Jira with filtering options.

Parameters:

• boardId: (Optional) Jira board ID to filter sprints by a specific board
• projectKey: (Optional) Project key to find sprints associated with the project
• state: (Optional) Sprint state to filter by (active, future, closed, or all), defaults to 'active'
• jiraHost: Your Jira domain
• email: Your Jira email
• apiToken: Your Jira API token

Usage Examples

Here are some example queries you can use with Claude:

"List all Jira projects in PROJECT"
"Get details for issue PROJECT-123"
"Search for issues assigned to John in PROJECT"
"List all members of PROJECT"
"Check what issues are assigned to Jane in PROJECT"
"Create a new bug issue titled 'Login page error' in PROJECT"
"List active sprints for PROJECT"

Continuous Development

This project is under active development. New tools and features are being added regularly to expand the integration capabilities with Jira. Future updates will include:

• Additional issue management tools
• Sprint and board management
• Advanced search and filtering options
• Custom field handling
• Workflow transitions
• And more!

Stay tuned by watching or starring the repository for updates.

Contributing

This is an open-source project and contributions are welcome! To contribute:

1. Fork the repository
2. Create your feature branch
3. Make your changes
4. Submit a pull request

Open Source

This code is completely open source. You are free to:

• Copy
• Modify
• Distribute
• Use commercially
• Use privately

No restrictions - do whatever you want with the code!

License

MIT