{
  "markdown": "# Jira MCP Server\n\n> An MCP server for [Jira](https://www.atlassian.com/software/jira) — connect any MCP-compatible client to your Jira projects, issues, sprints, and boards.\n\n[![MCP Compatible](https://img.shields.io/badge/MCP-compatible-blueviolet)](https://modelcontextprotocol.io)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.5-blue)](https://www.typescriptlang.org/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\n## What is this?\n\nAn [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that gives AI assistants and agents full access to your Jira instance — search issues with JQL, create and update tickets, manage sprints and boards, transition issues through workflows, and link related work — all through natural language.\n\nUse it with **Claude Desktop**, **Cursor**, **Windsurf**, **Cline**, **Continue**, or any MCP-compatible client to manage your projects without leaving the chat.\n\n## Why use this?\n\n- **14 built-in tools** — covers search, CRUD, transitions, comments, projects, boards, sprints, and backlog\n- **Full JQL support** — search issues with any Jira Query Language expression\n- **Workflow transitions** — move issues through your custom workflows by name\n- **Sprint management** — query sprint states, goals, and board backlogs\n- **Works with Jira Cloud** — connects to any `*.atlassian.net` instance\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"jira-mcp-server\"],\n      \"env\": {\n        \"JIRA_HOST\": \"your-domain.atlassian.net\",\n        \"JIRA_EMAIL\": \"you@example.com\",\n        \"JIRA_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n### Cursor / VS Code\n\nAdd to your MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"jira\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"jira-mcp-server\"],\n      \"env\": {\n        \"JIRA_HOST\": \"your-domain.atlassian.net\",\n        \"JIRA_EMAIL\": \"you@example.com\",\n        \"JIRA_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n### Manual\n\n```bash\nnpm install -g jira-mcp-server\nexport JIRA_HOST=your-domain.atlassian.net\nexport JIRA_EMAIL=you@example.com\nexport JIRA_API_TOKEN=your-api-token\njira-mcp-server\n```\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `JIRA_HOST` | Yes | Your Jira hostname (e.g. `your-domain.atlassian.net`) |\n| `JIRA_API_TOKEN` | Yes | Jira API token or Personal Access Token |\n| `JIRA_EMAIL` | Cond. | Your Jira email (required for Basic auth) |\n| `JIRA_AUTH_TYPE` | No | `basic` (default) or `bearer` (for PAT) |\n| `JIRA_API_VERSION` | No | REST API version (default: `3`) |\n\n### Getting your API token\n\n1. Go to [Atlassian API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens)\n2. Click **Create API token**\n3. Give it a name (e.g. \"MCP Server\") and copy the token\n4. Use your Atlassian email as `JIRA_EMAIL`\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `jira_search` | Search issues with JQL |\n| `jira_get_issue` | Get full issue details |\n| `jira_create_issue` | Create a new issue |\n| `jira_update_issue` | Update issue fields |\n| `jira_transition_issue` | Transition issue to new status |\n| `jira_add_comment` | Add a comment to an issue |\n| `jira_delete_issue` | Delete an issue (permanent) |\n| `jira_list_projects` | List accessible projects |\n| `jira_get_project` | Get project details |\n| `jira_get_issue_types` | List issue types for a project |\n| `jira_link_issues` | Create a link between two issues |\n| `jira_get_boards` | List Jira Software boards |\n| `jira_get_sprints` | List sprints for a board |\n| `jira_get_backlog` | Get board backlog items |\n\n## Usage Examples\n\n### Search issues with JQL\n\n```json\n{ \"tool\": \"jira_search\", \"arguments\": { \"jql\": \"project = PROJ AND status = Open ORDER BY created DESC\" } }\n```\n\n### Create a bug\n\n```json\n{\n  \"tool\": \"jira_create_issue\",\n  \"arguments\": {\n    \"projectKey\": \"PROJ\",\n    \"summary\": \"Login page broken on mobile\",\n    \"issueType\": \"Bug\",\n    \"priority\": \"High\",\n    \"labels\": \"mobile,urgent\"\n  }\n}\n```\n\n### Transition an issue\n\n```json\n{ \"tool\": \"jira_transition_issue\", \"arguments\": { \"issueKey\": \"PROJ-123\", \"transitionName\": \"In Progress\" } }\n```\n\n### Get sprint backlog\n\n```json\n{ \"tool\": \"jira_get_backlog\", \"arguments\": { \"boardId\": \"42\" } }\n```\n\n## Use Cases\n\n- **Project management** — \"Show me all open bugs in the mobile project\" → `jira_search` with JQL\n- **Sprint planning** — \"What's in the current sprint?\" → `jira_get_sprints` + `jira_get_backlog`\n- **Issue triage** — \"Create a bug for the login timeout\" → `jira_create_issue`\n- **Workflow automation** — \"Move PROJ-456 to In Review\" → `jira_transition_issue`\n- **Cross-project overview** — \"List all projects I have access to\" → `jira_list_projects`\n\n## API Coverage\n\n| Resource | Tools |\n|----------|-------|\n| Issues | `jira_search`, `jira_get_issue`, `jira_create_issue`, `jira_update_issue`, `jira_transition_issue`, `jira_delete_issue` |\n| Comments | `jira_add_comment` |\n| Projects | `jira_list_projects`, `jira_get_project` |\n| Issue Types | `jira_get_issue_types` |\n| Links | `jira_link_issues` |\n| Boards | `jira_get_boards` |\n| Sprints | `jira_get_sprints` |\n| Backlog | `jira_get_backlog` |\n\n## Development\n\n```bash\ngit clone https://github.com/friendlygeorge/jira-mcp-server.git\ncd jira-mcp-server\nnpm install\nnpm run build\nnpm start\n```\n\n## License\n\nMIT\n",
  "bytes": 5479,
  "sha": "904624c7b54e9a6631649bafa54af737b5da206c165e864d53c5a28e9d207361",
  "repo_slug": "friendlygeorge/jira-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_friendlygeorge_jira_mcp_server_fe374ac0/readme"
}