Atlassian MCP Server

A Model Context Protocol (MCP) server for integrating with Atlassian JIRA and Confluence. This server provides tools to interact with JIRA tickets and Confluence pages through the MCP protocol.

Features

Get JIRA ticket details
Search for JIRA tickets using JQL
Create new JIRA tickets
Add comments to JIRA tickets
Get Confluence page content
Search for content in Confluence

Prerequisites

Node.js 16 or higher
An Atlassian Cloud account
An Atlassian API token

Installation

Option 1: Install from Cline Marketplace (recommended)

Open Cline
Go to Settings > MCP Servers
Select the "Marketplace" tab
Search for "Atlassian"
Click "Install"
Configure your Atlassian credentials when prompted

Option 2: Install from npm

npm install -g atlassian-mcp-server

Option 3: Install from source

Clone the repository
Run the install script:

./install.sh

Or manually:

Install dependencies

npm install

Build the project

npm run build

Install globally

npm install -g .

Run the setup

atlassian-mcp-setup

Configuration

You can configure the server using the setup script, a configuration file, or environment variables.

Using the setup script (recommended)

Run the setup script to create your configuration file:

npx atlassian-mcp-setup

Or if installed locally:

npm run setup

The script will guide you through the configuration process and create a config.json file in the config directory.

Using a configuration file manually

Create a config.json file in the config directory (you can copy from config.sample.json)
Fill in your Atlassian details:

{
  "atlassian": {
    "baseUrl": "https://your-instance.atlassian.net",
    "email": "your-email@example.com",
    "token": "your-api-token-here"
  },
  "server": {
    "name": "atlassian-server",
    "version": "0.1.0"
  }
}

Using environment variables

Set the following environment variables:

ATLASSIAN_BASE_URL: Your Atlassian instance URL (e.g., https://your-instance.atlassian.net)
ATLASSIAN_EMAIL: Your Atlassian account email
ATLASSIAN_TOKEN: Your Atlassian API token
ATLASSIAN_CONFIG_PATH: (Optional) Path to a custom config file location

Getting an Atlassian API Token

Log in to your Atlassian account at https://id.atlassian.com/manage-profile/security/api-tokens
Click "Create API token"
Give your token a name (e.g., "MCP Server")
Copy the generated token (you won't be able to see it again)

Usage

Running the server

atlassian-mcp-server

Or if installed from source:

npm start

Integrating with Cline

Option 1: Install from Marketplace (recommended)

Open Cline
Go to Settings > MCP Servers
Select the "Marketplace" tab
Search for "Atlassian"
Click "Install"
Configure your Atlassian credentials when prompted

Option 2: Manual Configuration

If you've installed the server manually, add the following to your MCP settings:

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp-server",
      "args": [],
      "env": {
        "ATLASSIAN_CONFIG_PATH": "/path/to/your/config.json"
      },
      "disabled": false
    }
  }
}

Alternatively, you can provide the credentials directly in the settings:

{
  "mcpServers": {
    "atlassian": {
      "command": "atlassian-mcp-server",
      "args": [],
      "env": {
        "ATLASSIAN_BASE_URL": "https://your-instance.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@example.com",
        "ATLASSIAN_TOKEN": "your-api-token-here"
      },
      "disabled": false
    }
  }
}

Available Tools

get_jira_ticket

Get details of a JIRA ticket by key.

Parameters:

ticket_key: JIRA ticket key (e.g., "PROJ-123")

search_jira_tickets

Search for JIRA tickets using JQL.

Parameters:

jql: JQL query string
max_results: Maximum number of results to return (default: 10)

create_jira_ticket

Create a new JIRA ticket.

Parameters:

project_key: Project key (e.g., "PROJ")
summary: Ticket summary/title
description: Ticket description
issue_type: Issue type (e.g., "Bug", "Task", "Story") (default: "Task")

add_comment_to_jira_ticket

Add a comment to a JIRA ticket.

Parameters:

ticket_key: JIRA ticket key (e.g., "PROJ-123")
comment: Comment text

get_confluence_page

Get a Confluence page by ID.

Parameters:

page_id: Confluence page ID

search_confluence

Search for content in Confluence.

Parameters:

query: Search query
limit: Maximum number of results (default: 10)

Publishing to the Marketplace

This server is configured to be published to the Cline MCP Marketplace using the GitHub repository at: https://github.com/kompallik/ATLASSIAN-MCP

To publish updates:

Push your changes to the GitHub repository using the provided script:

npm run push-github

Add an icon.png file in the assets directory if not already present
Run the publish script:

npm run publish-mcp

Follow the prompts to publish to npm and/or create a distribution package
Submit your repository URL to the Cline MCP Marketplace team

License

MIT

Atlassian MCP Server

Integrations