home / mcp / mcp atlassian mcp server

MCP Atlassian MCP Server

mcp server for atlassian : https://github.com/sooperset/mcp-atlassian

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "arconixforge-mcp-atlassian": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-p",
        "8080:8080",
        "-v",
        "\"${HOME}/.mcp-atlassian:/home/app/.mcp-atlassian\"",
        "ghcr.io/sooperset/mcp-atlassian:latest",
        "--oauth-setup",
        "-v"
      ],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "ATLASSIAN_OAUTH_SCOPE": "read:jira-work write:jira-work read:confluence-content.all write:confluence-content offline_access",
        "ATLASSIAN_OAUTH_CLOUD_ID": "YOUR_CLOUD_ID_FROM_SETUP_WIZARD",
        "ATLASSIAN_OAUTH_CLIENT_ID": "YOUR_OAUTH_APP_CLIENT_ID",
        "ATLASSIAN_OAUTH_REDIRECT_URI": "http://localhost:8080/callback",
        "ATLASSIAN_OAUTH_CLIENT_SECRET": "YOUR_OAUTH_APP_CLIENT_SECRET"
      }
    }
  }
}

MCP Atlassian enables you to connect Jira and Confluence data from Atlassian Cloud or Server deployments to your AI assistant. It supports both Confluence and Jira, with flexible authentication options and deployment methods so you can automate updates, search content, and manage issues across your Atlassian workspace.

How to use

Use MCP Atlassian from your AI-enabled IDE or integration to perform tasks like updating Jira from notes, searching Confluence content, filtering Jira issues, or creating and managing documentation. You can operate with Cloud or Server deployments, choose either a direct HTTP-based connection or a local MCP process, and opt for per-user OAuth or server-level tokens. Ensure your Atlassian URLs and credentials are correctly configured for a smooth experience.

How to install

Prerequisites: you need Docker installed on your machine. You may also want an IDE integration (Cursor, Claude Desktop, or similar) to connect to the MCP server.

# Pull the pre-built MCP Atlassian image
docker pull ghcr.io/sooperset/mcp-atlassian:latest

Additional configurations and notes

Configure MCP Atlassian to connect to your Jira and Confluence instances using one of the provided methods. You can run the server via Docker with OAuth 2.0 flow for Cloud, or bring your own token for BYOT scenarios. The examples below show practical, ready-to-run commands and environment variables you’ll use in your setup.

Security and troubleshooting

Keep API tokens and OAuth credentials secure. Use SSL verification in production and disable write operations if you need a read-only setup for auditing. If you encounter authentication failures, verify that your tokens or PATs have the necessary scopes for Jira and Confluence and that the URLs are correct.

Available tools

jira_get_issue

Get details of a specific Jira issue by key.

jira_search

Search Jira issues using JQL.

jira_create_issue

Create a new Jira issue.

confluence_search

Search Confluence content using CQL.

confluence_get_page

Retrieve content of a Confluence page.

confluence_create_page

Create a new Confluence page.