Integrations

Provides system time integration with customizable date and time formatting and locale support.
Allows access to Jira issues directly from the IDE, including viewing assigned issues, getting detailed information on specific issues, and converting Jira issues into local tasks.

🔗 JIRA MCP Server for Cursor

✨ Features

📋 Access JIRA Directly From Cursor
- View your assigned issues without leaving your IDE
- Get detailed information on specific issues with one command
- Convert JIRA issues into local tasks seamlessly
⏰ System Time Integration
- Customizable date and time formatting
- Locale support via date-fns

🚀 Quick Start

Installation

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

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env
# Edit .env with your JIRA credentials

Configuration

Create a .env file with the following variables:

JIRA_HOST=https://your-instance.atlassian.net
JIRA_USERNAME=your-email@example.com
JIRA_API_TOKEN=your-jira-api-token-here

🔑 Important Note About JIRA API Tokens
Tokens may contain special characters, including the = sign
Place the token on a single line in the .env file
Do not add quotes around the token value
Paste the token exactly as provided by Atlassian

🛠️ Development Tools

MCP Inspector

The MCP Inspector is a powerful tool for testing and debugging your MCP server.

# Run the inspector (no separate build step needed)
npm run inspect

The inspector automatically:

Loads environment variables from .env
Cleans up occupied ports (5175, 3002)
Builds the project when needed
Starts the MCP server with your configuration
Launches the inspector UI

Visit the inspector at http://localhost:5175?proxyPort=3002

If you encounter port conflicts:

npm run cleanup-ports

Debugging with the Inspector

The inspector UI allows you to:

View all available MCP capabilities
Execute tools and examine responses
Analyze the JSON communication
Test with different parameters

For more details, see the MCP Inspector GitHub repository.

Integration with Claude Desktop

Test your MCP server directly with Claude:

Build and run your server:
npm run build # You must build the project before running it node dist/index.js
Configure Claude Desktop:
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
Add the MCP configuration:
{ "mcpServers": { "JIRA Tools": { "command": "node", "args": ["/absolute/path/to/your/project/dist/index.js"], "env": { "JIRA_USERNAME": "your-jira-username", "JIRA_API_TOKEN": "your-jira-api-token", "JIRA_HOST": "your-jira-host.atlassian.net" } } } }
Restart Claude Desktop and test with:
What time is it right now?
or
Show me my assigned JIRA issues.

🔌 Integration with Cursor IDE

⚠️ Important: You must build the project with npm run build before integrating with Cursor IDE or Claude Desktop.

Add this MCP server to your Cursor IDE's MCP configuration:

{
  "mcpServers": {
    "JIRA Tools": {
      "command": "node",
      "args": ["/absolute/path/to/your/project/dist/index.js"],
      "env": {
        "JIRA_USERNAME": "your-jira-username",
        "JIRA_API_TOKEN": "your-jira-api-token",
        "JIRA_HOST": "your-jira-host.atlassian.net"
      }
    }
  }
}

🧰 Available Tools

JIRA Tools

Tool	Description	Parameters	Returns
`jira_get_assigned_issues`	Retrieves all issues assigned to you	None	Markdown-formatted list of issues
`jira_get_issue`	Gets detailed information about a specific issue	`issueKey`: Issue key (e.g., PD-312)	Markdown-formatted issue details
`jira_create_task`	Creates a local task from a JIRA issue	`issueKey`: Issue key (e.g., PD-312)	Markdown-formatted task

System Time Tools

Tool	Description	Parameters	Returns
`get_system_time`	Gets the current system time	`format`: (Optional) date-fns format string	Formatted date/time string

📁 Project Structure

src/
 ├── features/        # MCP features (JIRA, system time)
 ├── server/          # MCP server implementation
 ├── shared/          # Shared utilities
 └── index.ts         # Main entry point

NPM Scripts

Command	Description
`npm run build`	Build the project
`npm run publish`	Build and publish package to npm registry
`npm run inspect`	Run with MCP inspector for debugging
`npm run cleanup-ports`	Release ports used by the inspector
`npm test`	Run tests

📘 Resources

📄 License

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

A Model Context Protocol server that integrates JIRA directly into Cursor IDE, allowing users to view assigned issues, get detailed information on specific tickets, and convert JIRA issues into local tasks without leaving their editor.