jira-mcp

nguyenvanduocit/jira-mcp

3.5

If you are the rightful owner of jira-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Go-based MCP connector for Jira that enables AI assistants like Claude to interact with Atlassian Jira.

Jira MCP

Control Jira from Cursor/Claude. Create/update issues, manage sprints and versions, add comments/worklogs, and run transitions from your editor.

Capabilities

  • Issues: get/create/update, child issues, JQL search, transitions
  • Sprints: list sprints, get active sprint, move up to 50 issues
  • Collaboration: comments, worklogs, related issues (links)
  • Versions: list and inspect released/unreleased versions
  • Output: compact text formatted for AI tools

Quick start

1) Get an API token

Create one at https://id.atlassian.com/manage-profile/security/api-tokens.

2) Add to Cursor

Use Docker or a local binary (STDIO; no ports needed).

Docker
{
  "mcpServers": {
    "jira": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "ATLASSIAN_HOST=https://your-company.atlassian.net",
        "-e", "ATLASSIAN_EMAIL=your-email@company.com",
        "-e", "ATLASSIAN_TOKEN=your-api-token",
        "ghcr.io/nguyenvanduocit/jira-mcp:latest"
      ]
    }
  }
}
Binary
{
  "mcpServers": {
    "jira": {
      "command": "/usr/local/bin/jira-mcp",
      "env": {
        "ATLASSIAN_HOST": "https://your-company.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@company.com",
        "ATLASSIAN_TOKEN": "your-api-token"
      }
    }
  }
}

3) Try it in Cursor

  • “Show my issues assigned to me”
  • “What’s in the current sprint for ABC?”
  • “Create a bug in ABC: Login fails on Safari”

Configuration

  • ATLASSIAN_HOST: https://your-company.atlassian.net
  • ATLASSIAN_EMAIL: your Atlassian email
  • ATLASSIAN_TOKEN: API token

Optional .env (if running locally):

ATLASSIAN_HOST=https://your-company.atlassian.net
ATLASSIAN_EMAIL=your-email@company.com
ATLASSIAN_TOKEN=your-api-token

HTTP mode (optional, for debugging):

jira-mcp -env .env -http_port 3000

Cursor config (HTTP mode):

{ "mcpServers": { "jira": { "url": "http://localhost:3000/mcp" } } }

Deeper docs

  • API and architecture: see docs/,

License

MIT — see LICENSE.