Skip to main content
Glama
enesjakozh

JIRA MCP Server

by klauseduard
GitHub
Python
  • Linux
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

JIRA MCP Server

A simple Model Context Protocol (MCP) "vibe-coded" server for integrating JIRA with Cursor IDE. MCP is an open protocol that enables seamless integration between LLM applications and external data sources and tools.

This implementation started out by discarding another JIRA MCP server that we failed to init in Cursor.

BEWARE! Even this document is almost entirely written by AI coding assistant.

Features

  • Get JIRA issues by key
  • Search issues using JQL (JIRA Query Language)
  • Create and update issues (note: may have limitations with heavily customized JIRA projects)
  • Add comments to issues
  • Clone issues (useful for working around mandatory custom fields, but may have limitations with complex project configurations)
  • Configurable field selection
  • Pagination support
  • Detailed error handling and logging
  • Log work

User Workflows

Search and Filter Flow

Issue Cloning Flow

For detailed technical architecture and system workflows, including issue lifecycle and authentication flows, see ARCHITECTURE.md.

About MCP

This server implements the Model Context Protocol specification, allowing Cursor IDE to seamlessly interact with JIRA data through its AI features. The protocol standardizes how LLM applications communicate with external data sources and tools.

Setup

  1. Create a virtual environment:
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
  1. Install dependencies:
pip install -r requirements.txt
  1. Configure environment variables: Create a .env file with:
JIRA_URL=your_jira_url JIRA_USERNAME=your_username JIRA_API_TOKEN=your_api_token

Usage

Run the server:

./run-jira-mcp.sh

Development

The project follows a modular structure:

src/ ├── core/ # Core JIRA client implementation │ ├── __init__.py │ ├── client.py # JiraClient class │ └── config.py # Configuration management ├── models/ # Pydantic models for validation │ ├── __init__.py │ ├── comment.py # Comment-related models │ ├── issue.py # Issue-related models │ └── worklog.py # Worklog-related models └── operations/ # MCP operation implementations ├── __init__.py ├── comments.py # Comment operations ├── issues.py # Issue operations ├── projects.py # Project operations └── worklog.py # Worklog operations

Key Components

  1. Models (src/models/)
    • IssueType, IssueArgs - Issue creation/update models
    • IssueTransitionArgs - Issue state transition model
    • CloneIssueArgs - Issue cloning model
    • CommentArgs, GetCommentsArgs - Comment models
    • LogWorkArgs - Work logging model
  2. Core (src/core/)
    • JiraClient - Main JIRA API client
    • JiraConfig - Configuration management
    • Error handling and logging
  3. Operations (src/operations/)
    • Issue management (get, search, create, update, clone)
    • Comment handling (add, get)
    • Work logging
    • Project listing

The project follows the implementation plan outlined in IMPLEMENTATION_PLAN.md.

Current version: v0.4

  • ✅ Basic JIRA integration
  • ✅ Search functionality with JQL support
  • ✅ Issue management (create, update, clone) with limitations for heavily customized projects
  • ✅ Comment functionality
  • ✅ Work logging

License

MIT

Security Considerations

This tool is primarily designed for personal workflow automation and individual developer use. Please be aware of the following security considerations:

⚠️ Usage Recommendations

  • Personal/Development Use: Ideal for individual developers managing their JIRA workflows
  • Small Team Use: Suitable for trusted team environments with proper security measures
  • NOT Recommended For:
    • Production deployment in its current form
    • Multi-tenant environments
    • Public-facing services
    • Processing sensitive/regulated data

🔒 Security Requirements

If you choose to use this tool, please ensure:

  1. Your JIRA instance uses HTTPS
  2. You're using API tokens (not passwords) for authentication
  3. Your .env file is properly secured and not committed to version control
  4. You understand the risks of running third-party tools with JIRA access

🛡️ Best Practices

  1. Regularly rotate your API tokens
  2. Monitor your JIRA audit logs for unexpected activity
  3. Use the most recent version of the tool
  4. Review the code before use in your environment

📝 Note on Enterprise Usage

This tool is not currently hardened for enterprise security requirements. If you need a solution for enterprise deployment, consider:

  • Implementing additional security controls
  • Conducting a security review
  • Contributing security improvements back to the project
  • Using official enterprise-grade alternatives

For security-related concerns or to report vulnerabilities, please open an issue or contact the maintainers directly.

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

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 enables seamless integration between Cursor IDE and JIRA, allowing users to retrieve issues, execute JQL searches, and log work through natural language interactions.

  1. Features
    1. User Workflows
      1. Search and Filter Flow
      2. Issue Cloning Flow
    2. About MCP
      1. Setup
        1. Usage
          1. Development
            1. Key Components
          2. Related Links
            1. License
              1. Security Considerations
                1. ⚠️ Usage Recommendations
                2. 🔒 Security Requirements
                3. 🛡️ Best Practices
                4. 📝 Note on Enterprise Usage

              Related MCP Servers

              • MCP Server for Cursor

                AntDX316
                -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.
                Last updated -
                598
                1

              • Cursor DB MCP Server

                jbdamask
                -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that enables AI assistants to explore and interact with Cursor IDE's SQLite databases, providing access to project data, chat history, and composer information.
                Last updated -
                21
                • Apple

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

              • Jira MCP Server

                InfinitIQ-Tech
                A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that enables interaction with Jira's REST API using natural language commands, allowing users to manage Jira projects, issues, comments, and workflows through Claude Desktop and other MCP clients.
                Last updated -
                10
                1
                MIT License

              View all related MCP servers

              Appeared in Searches

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/klauseduard/vibe-coded-jira-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server