jira-mcp

npmGitHub
  • Developer Tools
JavaScript
MIT
48
1
  • Apple
A
security – no known vulnerabilities (report Issue)
A
license - permissive license (MIT)
A
quality - confirmed to work

Provides capabilities for searching Jira issues using JQL and retrieving detailed issue information.

  1. Tools
  2. Prompts
  3. Resources
  4. Server Configuration
  5. README.md

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
jql_searchPerform enhanced JQL search in Jira
get_issueRetrieve details about an issue by its ID or key.

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
JIRA_API_KEYYesYour JIRA API token
JIRA_USER_EMAILYesThe email address associated with your JIRA account
JIRA_INSTANCE_URLYesYour actual JIRA instance URL
Need Help?View Source CodeReport Issue
README.md

JIRA MCP Server

An MCP server that enables Large Language Models (LLMs) to interact with JIRA through standardized tools and context. This server provides capabilities for searching issues using JQL and retrieving detailed issue information.

<a href="https://glama.ai/mcp/servers/4e3sqj7af1"><img width="380" height="200" src="https://glama.ai/mcp/servers/4e3sqj7af1/badge" alt="jira-mcp MCP server" /></a>

Features

  • JQL Search: Execute complex JQL queries with pagination support
  • Issue Details: Retrieve detailed information about specific JIRA issues

Prerequisites

  • npm installed
  • A JIRA instance with API access
  • JIRA API token or Personal Access Token
  • JIRA user email associated with the API token

Getting JIRA API Credentials

  1. Log in to your Atlassian account at https://id.atlassian.com
  2. Navigate to Security settings
  3. Under API tokens, select "Create API token"
  4. Give your token a meaningful name (e.g., "MCP Server")
  5. Copy the generated token - you won't be able to see it again!
  6. Use this token as your JIRA_API_KEY
  7. Use the email address associated with your Atlassian account as JIRA_USER_EMAIL

Usage

Integration with Claude Desktop

  1. Add the server configuration to Claude Desktop's config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "jira": { "command": "npx", "args": ["-y" "jira-mcp"], "env": { "JIRA_INSTANCE_URL": "https://your-instance.atlassian.net", "JIRA_USER_EMAIL": "your-email@company.com", "JIRA_API_KEY": "your-api-token" } } } }
  1. Restart Claude Desktop to load the new configuration.

Available Tools

1. JQL Search (jql_search)

Executes a JQL search query with customizable parameters.

Parameters:

  • jql (required): JQL query string
  • nextPageToken: Token for pagination
  • maxResults: Maximum number of results to return
  • fields: Array of field names to include
  • expand: Additional information to include

Example:

{ "jql": "project = 'MyProject' AND status = 'In Progress'", "maxResults": 10, "fields": ["summary", "status", "assignee"] }

2. Get Issue (get_issue)

Retrieves detailed information about a specific issue.

Parameters:

  • issueIdOrKey (required): Issue ID or key
  • fields: Array of field names to include
  • expand: Additional information to include
  • properties: Array of properties to include
  • failFast: Whether to fail quickly on errors

Example:

{ "issueIdOrKey": "PROJ-123", "fields": ["summary", "description", "status"], "expand": "renderedFields,names" }

Development

Configuration

Set up your environment variables before running the server. Create a .env file in the root directory:

JIRA_INSTANCE_URL=https://your-instance.atlassian.net JIRA_USER_EMAIL=your-email@company.com JIRA_API_KEY=your-api-token

Replace the values with:

  • Your actual JIRA instance URL
  • The email address associated with your JIRA account
  • Your JIRA API token (can be generated in Atlassian Account Settings)

Installation

  1. Clone this repository:
git clone <repository-url> cd jira-mcp
  1. Install dependencies:
npm install

Running with MCP Inspector

For testing and development, you can use the MCP Inspector:

npm run inspect

Adding New Tools

To add new tools, modify the ListToolsRequestSchema handler in index.js:

server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools: [ // Existing tools... { name: "your_new_tool", description: "Description of your new tool", inputSchema: { // Define input schema... } } ] }; });

Then implement the tool in the CallToolRequestSchema handler.

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a PR.

GitHub Badge

Glama performs regular codebase and documentation scans to:

  • Confirm that the MCP server is working as expected.
  • Confirm that there are no obvious security issues with dependencies of the server.
  • Extract server characteristics such as tools, resources, prompts, and required parameters.

Our directory badge helps users to quickly asses that the MCP server is safe, server capabilities, and instructions for installing the server.

Copy the following code to your README.md file:

Alternative MCP servers

  • zendesk-mcp-server

    -
    security
    F
    license
    -
    quality
    This server provides a comprehensive integration with Zendesk. Retrieving and managing tickets and comments. Ticket analyzes and response drafting. Access to help center articles as knowledge base.

  • jira-mcp-server

    -
    security
    -
    license
    -
    quality
    Tools for executing JQL queries. Tools for creating, editing, and deleting Jira tickets. Tools for listing Jira projects and statuses
    • Apple

  • mcp-atlassian

    A
    security
    A
    license
    A
    quality
    Model Context Protocol (MCP) server for Atlassian Cloud products (Confluence and Jira). This integration is designed specifically for Atlassian Cloud instances and does not support Atlassian Server or Data Center deployments.
    MIT

  • mcp-notion-server

    -
    security
    A
    license
    -
    quality
    MCP Server for the Notion API, enabling Claude to interact with Notion workspaces.
    MIT