Skip to main content
Glama
Sign In
enesjakozh

JIRA MCP Server for Cursor

by Dsazz
GitHub
TypeScript
1
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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:

  1. Build and run your server:
    npm run build # You must build the project before running it node dist/index.js
  2. Configure Claude Desktop:
    nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
  3. 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" } } } }
  4. 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

ToolDescriptionParametersReturns
jira_get_assigned_issuesRetrieves all issues assigned to youNoneMarkdown-formatted list of issues
jira_get_issueGets detailed information about a specific issueissueKey: Issue key (e.g., PD-312)Markdown-formatted issue details
jira_create_taskCreates a local task from a JIRA issueissueKey: Issue key (e.g., PD-312)Markdown-formatted task

System Time Tools

ToolDescriptionParametersReturns
get_system_timeGets the current system timeformat: (Optional) date-fns format stringFormatted 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

CommandDescription
npm run buildBuild the project
npm run publishBuild and publish package to npm registry
npm run inspectRun with MCP inspector for debugging
npm run cleanup-portsRelease ports used by the inspector
npm testRun tests

📘 Resources

📄 License

MIT © Stanislav Stepanenko

This server cannot be installed

-
security - not tested
F
license - not found
-
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.

  1. ✨ Features
    1. 🚀 Quick Start
      1. Installation
      2. Configuration
    2. 🛠️ Development Tools
      1. MCP Inspector
      2. Integration with Claude Desktop
    3. 🔌 Integration with Cursor IDE
      1. 🧰 Available Tools
        1. JIRA Tools
        2. System Time Tools
      2. 📁 Project Structure
        1. NPM Scripts
      3. 📘 Resources
        1. 📄 License

          Related MCP Servers

          • 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
            • Apple

          • 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
            • Linux
            • Apple

          • 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
            • Apple

          • Jira MCP Server

            maximepeabody
            -
            security
            A
            license
            -
            quality
            A Simple Model Context Protocol server that enables AI assistants to interact with Jira, allowing operations like fetching tickets, adding comments, and updating ticket status.
            Last updated -
            1
            Python
            Apache 2.0

          View all related MCP servers

          Appeared in Searches

          New MCP Servers

          ID: yw8bnyz919