@avidian/mcp-jira

MCP server for Jira Cloud — gives AI agents full context and control over Jira issues, projects, sprints, and workflows.

Installation

npm (requires Node.js ≥ 20)

npm install -g @avidian/mcp-jira

Compiled binary (no runtime needed)

sh -c "$(curl -fsSL https://raw.githubusercontent.com/avidianity/mcp-jira/main/install.sh)"

Or download manually from GitHub Releases.

Configuration

Set these environment variables:

Variable	Description
JIRA_BASE_URL	Your Jira Cloud URL (e.g., https://your-domain.atlassian.net)
JIRA_USER_EMAIL	Email of the Jira user
JIRA_API_TOKEN	API token (generate here)

Usage

stdio (default — Claude Desktop, VS Code, Cursor)

mcp-jira

HTTP (Streamable HTTP transport)

mcp-jira --transport http --port 5485

MCP client configuration

{
  "mcpServers": {
    "jira": {
      "command": "mcp-jira",
      "env": {
        "JIRA_BASE_URL": "https://your-domain.atlassian.net",
        "JIRA_USER_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Tools

Read

Tool	Description
get_issue	Get full issue details (description converted to Markdown)
search_issues	Search via JQL with pagination
get_issue_comments	List comments (bodies converted to Markdown)
get_issue_transitions	Get available status transitions
list_projects	List accessible projects
get_project	Get project details, issue types, components, versions
get_board	Get board configuration and columns
get_sprint	Get active/future/closed sprints for a board
get_user	Search users by name or email
list_attachments	List all attachments on an issue (shows image/media file IDs)
get_image	Fetch an image by attachment ID or ADF media UUID

Write

Tool	Description
create_issue	Create a new issue (accepts Markdown description)
update_issue	Update issue fields
add_comment	Add a comment (accepts Markdown)
transition_issue	Change issue status
assign_issue	Assign or unassign an issue
link_issues	Link two issues together

Development

# Install dependencies
bun install

# Run in dev mode
bun run dev

# Type check
bun run typecheck

# Lint
bun run lint

# Format
bun run format

# Build for npm
bun run build

# Compile native binary
bun run compile

License

MIT