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", "[email protected]",
        "-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": "[email protected]",
        "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
[email protected]
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/ → Docs index, API reference

License

MIT — see LICENSE.