# atlassian-mcp-server

Connect an agent to Jira, Confluence, and Compass through Atlassian’s remote MCP server. Use it to search and edit Atlassian content from an IDE.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 186 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/atlassian-mcp-server/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/atlassian-mcp-server

## What it does

This skill guides setup for an Atlassian Cloud connection covering Jira, Confluence, and Compass. An agent can look up issues and pages, create or edit records, and work with Compass components. Its actions follow the connected user’s Atlassian permissions.

For desktop clients, the instructions use the `mcp-remote` proxy with OAuth 2.1. Headless access can use an API token instead, but an Atlassian administrator must enable that authentication method first. The environment also needs `ATLASSIAN_EMAIL`, `ATLASSIAN_API_TOKEN`, and `ATLASSIAN_CLOUD_ID`. That admin setting is a prerequisite for token-based setup. The skill also describes project and space defaults in `AGENTS.md`.

## Requirements
- Works with: Atlassian, Jira, Confluence

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill atlassian-mcp-server -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/atlassian-mcp-server/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/atlassian-mcp-server/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill atlassian-mcp-server -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/atlassian-mcp-server/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill atlassian-mcp-server -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/atlassian-mcp-server/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/atlassian-mcp-server
```

2. **Manually: put the files in place**
- File: `.github/skills/atlassian-mcp-server/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill atlassian-mcp-server -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/atlassian-mcp-server
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/atlassian-mcp-server/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill atlassian-mcp-server -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/atlassian-mcp-server/SKILL.md

## When to use it
- search Jira issues by project and status
- create Jira tickets from requirements
- find Confluence pages by their content
- add a page to Confluence
- create a Compass component

## Example prompts
- Find open bugs assigned to me in Jira project `MYPROJ`.
- Create Jira tickets from these requirements: user authentication and password reset.
- Search the `DEV` Confluence space for pages about API documentation.

## Similar
- [atlassian-mcp](https://affpapa.org/en/nevibecode/skills/atlassian-mcp.md) — skill · 4800 installs
- [atlassian-templates](https://affpapa.org/en/nevibecode/skills/atlassian-templates.md) — skill · 680 installs
- [atlassian](https://affpapa.org/en/nevibecode/skills/atlassian.md) — skill · 329 installs
- [atlassian-admin](https://affpapa.org/en/nevibecode/skills/atlassian-admin.md) — skill · 682 installs
- [atlassian-rovo](https://affpapa.org/en/nevibecode/plugins/atlassian-rovo.md) — plugin · ★ 8052 repo stars
- [search-company-knowledge](https://affpapa.org/en/nevibecode/skills/search-company-knowledge.md) — skill · 505 installs

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
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
