# jira-mcp

Wires Jira and Confluence into your AI assistant: issues, sprints, comments, transitions and wiki pages without leaving the editor.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: raalarcon9705
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/raalarcon9705/jira-mcp
- Updated: 2026-05-29
- HTML: https://affpapa.org/en/nevibecode/mcp/raalarcon9705-jira-mcp

## What it does

The server exposes Jira Cloud to an agent: list projects and issue types, create and edit issues, read and write comments with pagination, move issues between states, assign people, search users, and run sprints through their lifecycle. Confluence pages come in by URL identifier, with HTML flattened to text.

Descriptions and comments accept Markdown and get converted to Atlassian Document Format on the way in — headings, bold and italic, code, lists, links, quotes, checkboxes. Payloads are validated with Yup schemas, and responses are trimmed field by field to keep token use down.

It runs through `npx`, so there is no global install. Three environment variables are mandatory: `JIRA_HOST`, `JIRA_EMAIL` and `JIRA_API_TOKEN`. Without them the server will not start, and the token has to be created in your Atlassian account settings. Only Jira Cloud is supported.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `JIRA_HOST`, `JIRA_EMAIL`, `JIRA_API_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: Jira

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add jira-mcp -e JIRA_HOST=<JIRA_HOST> -e JIRA_EMAIL=<JIRA_EMAIL> -e JIRA_API_TOKEN=<JIRA_API_TOKEN> -- npx -y raalarcon-jira-mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add raalarcon9705-jira-mcp --env JIRA_HOST=<JIRA_HOST> --env JIRA_EMAIL=<JIRA_EMAIL> --env JIRA_API_TOKEN=<JIRA_API_TOKEN> -- npx -y raalarcon-jira-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "raalarcon9705-jira-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "raalarcon-jira-mcp-server"
            ],
            "env": {
                "JIRA_HOST": "<JIRA_HOST>",
                "JIRA_EMAIL": "<JIRA_EMAIL>",
                "JIRA_API_TOKEN": "<JIRA_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "raalarcon9705-jira-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "raalarcon-jira-mcp-server"
            ],
            "env": {
                "JIRA_HOST": "<JIRA_HOST>",
                "JIRA_EMAIL": "<JIRA_EMAIL>",
                "JIRA_API_TOKEN": "<JIRA_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e JIRA_HOST=<JIRA_HOST> -e JIRA_EMAIL=<JIRA_EMAIL> -e JIRA_API_TOKEN=<JIRA_API_TOKEN> raalarcon9705-jira-mcp npx -y raalarcon-jira-mcp-server
```
Replace <…> with your own values

## When to use it
- file a Jira issue from inside the agent chat
- move an issue to another status without opening a browser
- pull a Confluence page into the model context as plain text
- list a sprint's issues and sort them by assignee
- add a Markdown comment to an existing issue

## Example prompts
- List every Jira project my account can see
- Create an issue in PROJ with a Markdown description: heading, reproduction steps and a code block
- Transition PROJ-123 to In Progress and assign it to me

## Similar
- [jira-cli](https://affpapa.org/en/nevibecode/skills/jira-cli.md) — skill · 635 installs
- [atlassian-mcp](https://affpapa.org/en/nevibecode/skills/atlassian-mcp.md) — skill · 4400 installs
- [search-company-knowledge](https://affpapa.org/en/nevibecode/skills/search-company-knowledge.md) — skill · 456 installs
- [atlassian](https://affpapa.org/en/nevibecode/skills/atlassian.md) — skill · 319 installs
- [jira-integration](https://affpapa.org/en/nevibecode/skills/jira-integration.md) — skill · 4900 installs
- [atlassian-rovo](https://affpapa.org/en/nevibecode/plugins/atlassian-rovo.md) — plugin · ★ 7604

## Other versions with the same name
- [jira-mcp · xcollantes](https://affpapa.org/en/nevibecode/mcp/jira-mcp.md) — ★ 8

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md