# mcp-atlassian

> MCP Server

The MCP Atlassian repository provides a Model Context Protocol (MCP) server for integrating with Atlassian products like Confluence and Jira, supporting both Cloud and Server/Data Center deployments. The MCP Atlassian

## Overview

- **Category:** Developer Tools
- **Language:** Python
- **Stars:** 5743
- **Forks:** 79
- **Owner:** sooperset
- **GitHub:** https://github.com/sooperset/mcp-atlassian
- **Created:** 2024-12-03T09:25:20+00:00
- **Updated:** 2025-03-28T22:18:00+00:00
- **Source:** https://model-context-protocol.com/servers/mcp-atlassian-confluence-jira-integration-server

## Setup

## Setup

1.  **Authentication Setup:** Generate authentication tokens for Confluence & Jira.
    *   **For Cloud:** Go to https://id.atlassian.com/manage-profile/security/api-tokens, create an API token, and copy it.
    *   **For Server/Data Center:** Go to your profile, create a personal access token, set expiry, and copy it.
2.  **Installation:** Choose one of the following installation methods:
    *   Using uv: `brew install uv; uvx mcp-atlassian`
    *   Using pip: `pip install mcp-atlassian`
    *   Using Docker: `git clone https://github.com/sooperset/mcp-atlassian.git; cd mcp-atlassian; docker build -t mcp/atlassian .`
3.  **Configuration and Usage:** Configure the MCP server using command line arguments, including only the arguments needed for your use case.
    *   **For Cloud:** `uvx mcp-atlassian --confluence-url https://your-company.atlassian.net/wiki --confluence-username your.email@company.com --confluence-token your_api_token --jira-url https://your-company.atlassian.net --jira-username your.email@company.com --jira-token your_api_token`
    *   **For Server/Data Center:** `uvx mcp-atlassian --confluence-url https://confluence.your-company.com --confluence-personal-token your_token --jira-url https://jira.your-company.com --jira-personal-token your_token`
    *   **Optional Arguments:** Use optional arguments like `--transport`, `--port`, `--[no-]confluence-ssl-verify`, `--[no-]jira-ssl-verify`, `--confluence-spaces-filter`, `--jira-projects-filter`, `--read-only`, and `--verbose` to customize the server.
    *   **Environment Variables:** Alternatively, configure using environment variables as defined in `.env.example`.

## Tools

## Available Tools

		1. `confluence_search` (Search Confluence content using CQL)
		2. `confluence_get_page` (Get content of a specific Confluence page)
		3. `confluence_get_page_children` (Get child pages of a specific Confluence page)
		4. `confluence_get_page_ancestors` (Get parent pages of a specific Confluence page)
		5. `confluence_get_comments` (Get comments for a specific Confluence page)
		6. `confluence_create_page` (Create a new Confluence page)
		7. `confluence_update_page` (Update an existing Confluence page)
		8. `confluence_delete_page` (Delete an existing Confluence page)
		9. `jira_get_issue` (Get details of a specific Jira issue)
		10. `jira_search` (Search Jira issues using JQL)
		11. `jira_get_project_issues` (Get all issues for a specific Jira project)
		12. `jira_create_issue` (Create a new issue in Jira)
		13. `jira_update_issue` (Update an existing Jira issue)
		14. `jira_delete_issue` (Delete an existing Jira issue)
		15. `jira_get_transitions` (Get available status transitions for a Jira issue)
		16. `jira_transition_issue` (Transition a Jira issue to a new status)
		17. `jira_add_worklog` (Add a worklog entry to a Jira issue)
		18. `jira_get_worklog` (Get worklog entries for a Jira issue)
		19. `jira_link_to_epic` (Link an issue to an Epic)
		20. `jira_get_epic_issues` (Get all issues linked to a specific Epic)