JIRA MCP Server for Cursor

🔗 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

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

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.

Related MCP Servers

MCP Atlassian
sooperset
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.
Last updated -
27
1,659
Python
MIT License
HH JIRA MCP Server
alexeydubinin
A
security
F
license
A
quality
A Model Context Protocol server that enables integration with JIRA, allowing users to interact with JIRA tasks and issues through Claude AI assistant.
Last updated -
3
2
Python
JIRA MCP Server
klauseduard
-
security
F
license
-
quality
A Model Context Protocol server that enables seamless integration between Cursor IDE and JIRA, allowing users to retrieve issues, execute JQL searches, and log work through natural language interactions.
Last updated -
Python
Jira MCP Server
ParasSolanki
A
security
A
license
A
quality
A Model Context Protocol server that provides integration with Jira, allowing Large Language Models to interact with Jira projects, boards, sprints, and issues through natural language.
Last updated -
5
87
2
TypeScript
MIT License

View all related MCP servers

JIRA MCP Server