Jira MCP
A Go-based MCP (Model Control Protocol) connector for Jira that enables AI assistants like Claude to interact with Atlassian Jira. This tool provides a seamless interface for AI models to perform common Jira operations.
Features
- Get detailed issue information
- Create, update, and search issues (including child issues)
- List all available issue types and statuses
- Add and retrieve comments
- Add worklogs to issues
- List and manage sprints
- Retrieve issue history and relationships
- Link issues and get related issues
- Transition issues through workflows
Installation
**Requirements:** Go 1.20+ (for building from source)
There are several ways to install Jira MCP:
Option 1: Download from GitHub Releases
- Visit the [GitHub Releases](https://github.com/nguyenvanduocit/jira-mcp/releases) page
- Download the binary for your platform: - `jira-mcp_linux_amd64` for Linux - `jira-mcp_darwin_amd64` for macOS - `jira-mcp_windows_amd64.exe` for Windows
- Make the binary executable (Linux/macOS): ```bash chmod +x jira-mcp_* ```
- Move it to your PATH (Linux/macOS): ```bash sudo mv jira-mcp_* /usr/local/bin/jira-mcp ```
Option 2: Go install
Option 3: Docker
Using Docker directly
- Pull the pre-built image from GitHub Container Registry: ```bash docker pull ghcr.io/nguyenvanduocit/jira-mcp:latest ```
- Or build the Docker image locally: ```bash docker build -t jira-mcp . ```
Configuration
Environment Variables
The following environment variables are required for authentication:
You can set these:
- Directly in the Docker run command (recommended)
- Through a `.env` file (optional for local development, use the `-env` flag)
- Directly in your shell environment
Using with Claude and Cursor
To make Jira MCP work with Claude and Cursor, you need to add configuration to your Cursor settings.
Step 1: Install Jira MCP
Choose one of the installation methods above (Docker recommended).
Step 2: Configure Cursor
- Open Cursor
- Go to Settings > MCP > Add MCP Server
- Add the following configuration:
Option A: Using Docker (Recommended)
Option B: Using Local Binary
Step 3: Test Connection
You can test if the connection is working by asking Claude in Cursor:
Contributing
- Fork the repository
- Create your feature branch (`git checkout -b feature/amazing-feature`)
- Commit your changes (`git commit -m 'Add some amazing feature'`)
- Push to the branch (`git push origin feature/amazing-feature`)
- Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
For a list of recent changes, see [CHANGELOG.md](./CHANGELOG.md).