mcp server

jira-mcp

A Model Context Protocol (MCP) server for Jira Cloud integration with AI assistants

icy-r/jira-mcpcommunitylistedunreviewed

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

Node.js 20 or newer

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "icy-r-jira-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@icy-r/jira-mcp"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 23, 2026

Jira MCP

A Model Context Protocol (MCP) server for Jira Cloud. Enables AI assistants to manage issues, sprints, projects, and more.

Quick Start

npx @icy-r/jira-mcp

MCP Configuration

Add to your MCP client (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@icy-r/jira-mcp"],
      "env": {
        "JIRA_BASE_URL": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Get your API token: Atlassian API Tokens

Environment Variables

Variable	Description	Required
`JIRA_BASE_URL`	Jira instance URL	Yes
`JIRA_EMAIL`	Your Atlassian email	Yes
`JIRA_API_TOKEN`	API token	Yes
`JIRA_MCP_USE_TOON`	Enable TOON format	No

Tools

Tool	Actions
`jira_issues`	get, create, update, delete, search, transition, assign
`jira_projects`	list, get, get_statuses, get_versions, create_version
`jira_sprints`	list, get, get_issues, get_active, create, update
`jira_boards`	list, get, get_config, get_issues, get_backlog
`jira_comments`	list, get, add, update, delete
`jira_links`	get_link_types, list, create, remove
`jira_worklogs`	list, add, update, delete
`jira_users`	get_current, get, search, get_assignable
`jira_fields`	list, list_custom, search, get_id
`jira_audit`	get_status, set_dry_run, get_session_log

Search Presets

{ "action": "search", "preset": "my_sprint_issues" }

Available: my_issues, current_sprint, my_sprint_issues, recently_updated, high_priority, due_soon

Safety Features

Destructive actions require confirmation:

{ "action": "delete", "issueKey": "PROJ-123", "confirm": true }

Preview changes with dry-run:

{ "action": "update", "issueKey": "PROJ-123", "summary": "New title", "dryRun": true }

Development

git clone https://github.com/icy-r/jira-mcp.git
cd jira-mcp
pnpm install
pnpm build
pnpm test

License

MIT