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
npminstalled
- 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
- Log in to your Atlassian account at https://id.atlassian.com
- Navigate to Security settings
- Under API tokens, select "Create API token"
- Give your token a meaningful name (e.g., "MCP Server")
- Copy the generated token - you won't be able to see it again!
- Use this token as your
JIRA_API_KEY
- Use the email address associated with your Atlassian account as
JIRA_USER_EMAIL
Usage
Integration with Claude Desktop
- 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- 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:
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:
Development
Configuration
Set up your environment variables before running the server. Create a
.env file in the root directory: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
Installing via Smithery
To install JIRA for Claude Desktop automatically via Smithery:
Manual Installation
- Clone this repository:
- Install dependencies:
Running with MCP Inspector
For testing and development, you can use the MCP Inspector:
Adding New Tools
To add new tools, modify the
ListToolsRequestSchema handler in index.js:Then implement the tool in the
CallToolRequestSchema handler.License
MIT
Contributing
Contributions are welcome! Please feel free to submit a PR.
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
npminstalled
- 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
- Log in to your Atlassian account at https://id.atlassian.com
- Navigate to Security settings
- Under API tokens, select "Create API token"
- Give your token a meaningful name (e.g., "MCP Server")
- Copy the generated token - you won't be able to see it again!
- Use this token as your
JIRA_API_KEY
- Use the email address associated with your Atlassian account as
JIRA_USER_EMAIL
Usage
Integration with Claude Desktop
- 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- 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:
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:
Development
Configuration
Set up your environment variables before running the server. Create a
.env file in the root directory: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
Installing via Smithery
To install JIRA for Claude Desktop automatically via Smithery:
Manual Installation
- Clone this repository:
- Install dependencies:
Running with MCP Inspector
For testing and development, you can use the MCP Inspector:
Adding New Tools
To add new tools, modify the
ListToolsRequestSchema handler in index.js:Then implement the tool in the
CallToolRequestSchema handler.License
MIT
Contributing
Contributions are welcome! Please feel free to submit a PR.