Jira MCP Server 🚀

Custom MCP server for Agrobank's self-hosted Jira (itjira.agrobank.uz)

Setup

Option A — Run with Node

1. Install dependencies

npm install

2. Configure credentials

Edit the .env file:

JIRA_BASE_URL=https://itjira.agrobank.uz
JIRA_EMAIL=your.email@agrobank.uz
JIRA_PASSWORD=your_password

3a. Hook up Claude Desktop

Open Claude Desktop config:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-servers/index.js"],
      "env": {
        "JIRA_BASE_URL": "https://itjira.agrobank.uz",
        "JIRA_EMAIL": "your.email@agrobank.uz",
        "JIRA_PASSWORD": "your_password"
      }
    }
  }
}

Restart Claude Desktop and you're good.

3b. Hook up Claude Code

One-liner via the CLI (user scope, available across all projects):

claude mcp add jira \
  -s user \
  -e JIRA_BASE_URL=https://itjira.agrobank.uz \
  -e JIRA_EMAIL=your.email@agrobank.uz \
  -e JIRA_PASSWORD=your_password \
  -- node /absolute/path/to/mcp-servers/index.js

Or drop it in ~/.claude.json manually:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-servers/index.js"],
      "env": {
        "JIRA_BASE_URL": "https://itjira.agrobank.uz",
        "JIRA_EMAIL": "your.email@agrobank.uz",
        "JIRA_PASSWORD": "your_password"
      }
    }
  }
}

Check it loaded:

claude mcp list

Option B — Run with Docker

1. Build the image

docker build -t jira-mcp:latest .

Or with compose:

docker compose build

2a. Wire up Claude Desktop

MCP talks over stdio, so Claude Desktop spawns the container per session. Use -i --rm and pass env vars through:

{
  "mcpServers": {
    "jira": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "JIRA_BASE_URL",
        "-e", "JIRA_EMAIL",
        "-e", "JIRA_PASSWORD",
        "jira-mcp:latest"
      ],
      "env": {
        "JIRA_BASE_URL": "https://itjira.agrobank.uz",
        "JIRA_EMAIL": "your.email@agrobank.uz",
        "JIRA_PASSWORD": "your_password"
      }
    }
  }
}

Why this shape:

-i keeps stdin open (MCP needs JSON-RPC over stdio)
--rm cleans up when Claude Desktop closes the pipe
-e VAR (no =value) inherits from the env block — secrets never get baked into the image
No -t (no TTY) and no port mapping — pure stdio, no listener

Restart Claude Desktop.

2b. Wire up Claude Code

claude mcp add jira \
  -s user \
  -e JIRA_BASE_URL=https://itjira.agrobank.uz \
  -e JIRA_EMAIL=your.email@agrobank.uz \
  -e JIRA_PASSWORD=your_password \
  -- docker run -i --rm \
       -e JIRA_BASE_URL -e JIRA_EMAIL -e JIRA_PASSWORD \
       jira-mcp:latest

Verify:

claude mcp list

Available Tools

| Tool | Description | |------|-------------| | get_my_issues | Get all issues assigned to you (filter by status) | | search_issues | Search by keyword or JQL | | get_issue | Get full details of an issue (e.g. PROJ-123) | | create_issue | Create a new issue or subtask (pass parentIssueKey for subtasks) | | add_comment | Add a comment to an issue | | get_transitions | See available status transitions | | transition_issue | Change issue status (To Do → In Progress → Done) | | get_projects | List all projects you have access to | | update_issue | Update priority, summary, or description | | get_current_user | Get the currently authenticated Jira user |

Example prompts in Claude

"Show me my current Jira tasks"
"What issues do I have In Progress?"
"Get details of BANK-456"
"Create a subtask under MOBCORE-565 titled 'Fix login bug'"
"Add a comment to BANK-123: done with testing"
"Move BANK-789 to Done"
"Bump priority of BANK-100 to High"

MCP Servers