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.

• 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

Requirements: Go 1.20+ (for building from source)

There are several ways to install Jira MCP:

1. Visit the GitHub Releases page
2. 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
3. Make the binary executable (Linux/macOS):

   chmod +x jira-mcp_*

4. Move it to your PATH (Linux/macOS):

   sudo mv jira-mcp_* /usr/local/bin/jira-mcp

go install github.com/nguyenvanduocit/jira-mcp@latest

1. Pull the pre-built image from GitHub Container Registry:

   docker pull ghcr.io/nguyenvanduocit/jira-mcp:latest

2. Or build the Docker image locally:

   docker build -t jira-mcp .

The following environment variables are required for authentication:

ATLASSIAN_HOST=your_atlassian_host
ATLASSIAN_EMAIL=your_email
ATLASSIAN_TOKEN=your_token

You can set these:

1. Directly in the Docker run command (recommended)
2. Through a .env file (optional for local development, use the -env flag)
3. Directly in your shell environment

To make Jira MCP work with Claude and Cursor, you need to add configuration to your Cursor settings.

Choose one of the installation methods above (Docker recommended).

1. Open Cursor
2. Go to Settings > MCP > Add MCP Server
3. Add the following configuration:

{
  "mcpServers": {
    "jira": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "ATLASSIAN_HOST=your_jira_instance.atlassian.net",
        "-e", "ATLASSIAN_EMAIL=your_email@example.com",
        "-e", "ATLASSIAN_TOKEN=your_atlassian_api_token",
        "ghcr.io/nguyenvanduocit/jira-mcp:latest"
      ]
    }
  }
}

{
  "mcpServers": {
    "jira": {
      "command": "/path/to/jira-mcp",
      "args": ["-env", "/path/to/.env"]
    }
  }
}

You can test if the connection is working by asking Claude in Cursor:

@https://your_jira_instance.atlassian.net/browse/PROJ-123 get issue

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

For a list of recent changes, see CHANGELOG.md.