MCP Atlassian

Overview

The MCP Atlassian server provides programmatic access to Jira and other Atlassian services through the Model Context Protocol. Run it in Docker with your Jira credentials to query issues, manage projects, and interact with Atlassian tools.

Quick Start

Pull and run the container with your Jira credentials:

docker pull ghcr.io/sooperset/mcp-atlassian:latest

docker run --rm -i \
  -e JIRA_URL=https://your-company.atlassian.net \
  -e JIRA_USERNAME=your.email@company.com \
  -e JIRA_API_TOKEN=your_api_token \
  ghcr.io/sooperset/mcp-atlassian:latest

With script (faster):

Run the bundled script with your API token:

JIRA_API_TOKEN=your_token bash scripts/run_mcp_atlassian.sh

Environment Variables

• JIRA_URL: Your Atlassian instance URL (e.g., https://company.atlassian.net)
• JIRA_USERNAME: Your Jira email address
• JIRA_API_TOKEN: Your Jira API token (create in Account Settings → Security)

Using MCP Atlassian with Clawdbot

Once running, the MCP server exposes Jira tools for use. Reference the container as an MCP source in your Clawdbot config to query issues, create tasks, or manage Jira directly from your agent.

Resources

scripts/

• run_mcp_atlassian.sh - Simplified runner script with credential handling