Skip to content
jtk

Quick Start

  1. Install jtk

    Terminal window
    curl -fsSL https://raw.githubusercontent.com/zach-snell/jtk/main/install.sh | bash

  2. Authenticate with Jira

    Terminal window
    jtk auth

    Enter your Jira domain, email, and API token when prompted.

  3. Run your first command

    Terminal window
    # List your projects
    jtk projects list
    

    # Search for issues assigned to you
    jtk issues search "assignee = currentUser() ORDER BY updated DESC"
    

    # Get a specific issue
    jtk issues get PROJ-123

  4. Set up MCP for your AI agent

    Add to your Claude Desktop config:

    {
      "mcpServers": {
        "jtk": {
          "command": "jtk",
          "args": ["mcp"]
        }
      }
    }

    Restart your AI client, then try a conversation like:

    “What issues are assigned to me in the PROJ project?”

    “Create a bug report in PROJ: Login button is unresponsive on mobile”

    “What’s the status of PROJ-456? Show me the dev info too.”

Example AI Conversation

Section titled “Example AI Conversation”

Once MCP is configured, your AI agent can interact with Jira naturally:

You: What’s in the current sprint for board 42?

AI: Let me check the active sprint for board 42.

Uses manage_boards with action get_active_sprint, then get_sprint_issues

Sprint: “Sprint 15” (Jan 13 - Jan 27)

KeySummaryStatusAssignee
PROJ-100Add OAuth supportIn ProgressJane
PROJ-101Fix pagination bugDoneBob
PROJ-102Update API docsTo DoUnassigned

1 of 3 issues complete (33%)