MCP Atlassian Cloud

The most comprehensive Jira MCP server available. 72 tools. Token-optimized. Production-ready.

Why This Server?

| | This Server | Others | |--|-------------|--------| | Jira Tools | 72 | 16-38 | | Token Savings | Up to 95% | None | | Markdown → ADF | Official @atlaskit | Custom parsers | | Hybrid ADF | Yes | No |

Features

• 72 Jira Tools - The deepest Jira coverage: Issues, Sprints, Epics, Boards, Filters, Changelog, Bulk ops
• Save 70-95% Tokens - Built-in response_mode returns only what you need
• Perfect Markdown → ADF - Official @atlaskit libraries = 100% Jira-compatible, zero formatting bugs
• Hybrid ADF Format - Mix Markdown + raw ADF for panels, status badges, mentions
• 3 Transports - npx (fastest), Docker (isolated), HTTP (teams)
• Production Ready - Metadata caching, retry with backoff, rate limiting

Quick Start

Option 1: npx (Recommended)

The fastest way to get started. Requires Node.js 20+.

npx @zierocode/mcp-atlassian-cloud

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "Jira": {
      "command": "npx",
      "args": ["@zierocode/mcp-atlassian-cloud@latest"],
      "env": {
        "ATLASSIAN_DOMAIN": "your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "[email protected]",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

Claude Code (~/.claude.json):

{
  "mcpServers": {
    "Jira": {
      "type": "stdio",
      "command": "npx",
      "args": ["@zierocode/mcp-atlassian-cloud@latest"],
      "env": {
        "ATLASSIAN_DOMAIN": "your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "[email protected]",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

Option 2: Docker

For isolated environments or when Node.js is not available.

docker pull ghcr.io/zierocode/mcp-atlassian-cloud:latest

Claude Desktop:

{
  "mcpServers": {
    "Jira": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "ATLASSIAN_DOMAIN=your-domain.atlassian.net",
        "-e", "[email protected]",
        "-e", "ATLASSIAN_API_TOKEN",
        "ghcr.io/zierocode/mcp-atlassian-cloud:latest"
      ],
      "env": {
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

Option 3: HTTP (Self-Hosted)

For shared team environments. Deploy your own server using the Deployment Guide.

Claude Code (~/.claude.json):

{
  "mcpServers": {
    "Jira": {
      "type": "http",
      "url": "https://YOUR-SERVER-URL/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Getting Your API Token

1. Go to Atlassian API Tokens
2. Click "Create API token"
3. Give it a name (e.g., "Claude MCP")
4. Copy and save the token

Transport Comparison

| Feature | npx | Docker | HTTP | |---------|-----|--------|------| | Startup time | ~1s | ~3s | Instant | | Disk usage | ~50MB | ~275MB | 0 | | Offline support | Yes | Yes | No | | Auto-update | Yes | Manual | N/A | | Isolation | No | Yes | N/A | | Best for | Local dev | Secure/offline | Teams |

72 Tools Across 16 Categories

| Category | Tools | Description | |----------|-------|-------------| | Issues | 6 | CRUD, Search, Bulk create | | Transitions | 3 | Status changes, Assignment | | Comments | 4 | Add, Edit, Delete comments | | Worklogs | 4 | Time tracking | | Attachments | 4 | List, Download, Delete | | Issue Links | 4 | Link issues, Remote links | | Watchers | 3 | Add/Remove watchers | | Changelog | 2 | Track changes | | Projects | 9 | Components, Versions | | Users | 4 | Search, Get user info | | Boards | 4 | Scrum/Kanban boards | | Sprints | 6 | Sprint management | | Epics | 5 | Epic management | | Filters | 4 | JQL filters | | Metadata | 8 | Fields, Types, Priorities | | Cache | 2 | Cache stats, Clear |

Token Optimization

Stop wasting tokens on data you don't need.

| Mode | Output | Tokens | Savings | |------|--------|--------|---------| | full | All 50+ fields | ~2,000 | - | | summary | Key, summary, status, assignee | ~600 | 70% | | keys_only | Just ["PROJ-1", "PROJ-2"] | ~100 | 95% |

Default: summary - Get what matters, skip the noise.

Markdown → ADF Conversion

No more broken formatting. Uses official @atlaskit libraries - the same ones Jira uses internally.

| Markdown | Jira ADF | |----------|----------| | **bold** | strong | | *italic* | em | | ~~strike~~ | strike | | `code` | code | | [link](url) | link | | # Heading | heading | | - bullet | bulletList | | 1. ordered | orderedList | | > quote | blockquote | | ``` code ``` | codeBlock |

Hybrid ADF Format (Exclusive)

Unlock every Jira feature. Mix simple Markdown with raw ADF for panels, status badges, mentions, and more:

{
  "description_blocks": [
    { "markdown": "# Summary\nSome **bold** text" },
    { "adf": { "type": "panel", "attrs": { "panelType": "info" }, "content": [...] } },
    { "markdown": "- Item 1\n- Item 2" }
  ]
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | ATLASSIAN_DOMAIN | Yes | e.g., mycompany.atlassian.net | | ATLASSIAN_EMAIL | Yes | Your Atlassian account email | | ATLASSIAN_API_TOKEN | Yes | API token from Atlassian | | CLIENT_API_KEY | No | Enable API key auth (HTTP mode) | | PORT | No | Default: 8080 (HTTP mode) |

Self-Hosting

# Clone
git clone https://github.com/zierocode/mcp-atlassian-cloud
cd mcp-atlassian-cloud

# Configure
cp .env.example .env
# Edit .env with your credentials

# Run
npm install
npm run build
npm start

# Health check
curl http://localhost:8080/health

Documentation

| Document | Description | |----------|-------------| | Installation | Setup for all MCP clients | | API Reference | All 72 tools documented | | Deployment | npx, Docker, Cloud Run | | Troubleshooting | Quick fixes | | Development | Contributing guide |

Known Issues (Anthropic Bugs)

| Issue | Status | Workaround | |-------|--------|------------| | Claude Desktop remote MCP | Bug | Use npx or Docker instead | | OAuth 2.0 in Claude Desktop | Bug | Use API Token auth |

License

MIT