atlassian-mcp-server — Claude Code skill: features and setup
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.
no license 186 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill atlassian-mcp-server -a claude-codeWhat atlassian-mcp-server 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.
What it helps with
- 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 for the agent
- Find open bugs assigned to me in Jira project
MYPROJ. - Create Jira tickets from these requirements: user authentication and password reset.
- Search the
DEVConfluence space for pages about API documentation.
How to install atlassian-mcp-server
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill atlassian-mcp-server -a claude-code2Manually: put the files in place
~/.claude/skills/atlassian-mcp-server/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/atlassian-mcp-server/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill atlassian-mcp-server -a codex2Manually: put the files in place
.agents/skills/atlassian-mcp-server/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill atlassian-mcp-server -a cursor2Manually: put the files in place
.cursor/skills/atlassian-mcp-server/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/atlassian-mcp-server2Manually: put the files in place
.github/skills/atlassian-mcp-server/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill atlassian-mcp-server -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/atlassian-mcp-serverManually: put the files in place
.devin/skills/atlassian-mcp-server/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill atlassian-mcp-server -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about atlassian-mcp-server
How do I install atlassian-mcp-server in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill atlassian-mcp-server -a claude-code. The skill file is placed at ~/.claude/skills/atlassian-mcp-server/SKILL.md.
What does atlassian-mcp-server do?
It connects an AI agent to Jira, Confluence, and Compass through Atlassian’s remote MCP service. The agent can search and change content under the user’s existing permissions.
What is required for headless authentication?
An Atlassian administrator must enable API token authentication. Set ATLASSIAN_EMAIL, ATLASSIAN_API_TOKEN, and ATLASSIAN_CLOUD_ID in the environment.