MCP Atlassian

by adamjbird2

15.6k downloads Not rated yet MIT license

About

Interact with Atlassian products like Confluence and Jira, supporting both Cloud and Server/Data Center deployments.

Details

License
MIT license

Explore

Jira Demo

<details>
<summary>Confluence Demo</summary>

Confluence Demo
</details>

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Atlassian
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

First, generate the necessary authentication tokens:

Choose one of these installation methods:


You can configure the MCP server using command line arguments. The server supports using either Confluence, Jira, or both services - include only the arguments needed for your use case.

Using uvx (recommended) - Cloud:

json
{
"mcpServers": {
"mcp-atlassian": {
"command": "uvx",
"args": [
"mcp-atlassian",
"--confluence-url=https://your-company.atlassian.net/wiki",
"[email protected]",
"--confluence-token=your_api_token",
"--jira-url=https://your-company.atlassian.net",
"[email protected]",
"--jira-token=your_api_token"
]
}
}
}

<details>
<summary>Using uvx (recommended) - Server/Data Center </summary>

json
{
"mcpServers": {
"mcp-atlassian": {
"command": "uvx",
"args": [
"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"
]
}
}
}
</details>

<details>
<summary>Using pip</summary>

> Note: Examples below use Atlassian Cloud configuration. For Server/Data Center, use the corresponding arguments (--confluence-personal-token, --jira-personal-token) as shown in the Configuration section above.

json
{
"mcpServers": {
"mcp-atlassian": {
"command": "python",
"args": [
"-m",
"mcp-atlassian",
"--confluence-url=https://your-company.atlassian.net/wiki",
"[email protected]",
"--confluence-token=your_api_token",
"--jira-url=https://your-company.atlassian.net",
"[email protected]",
"--jira-token=your_api_token"
]
}
}
}
</details>

<details>
<summary>Using docker</summary>

> Note: Examples below use Atlassian Cloud configuration. For Server/Data Center, use the corresponding arguments (--confluence-personal-token, --jira-personal-token) as shown in the Configuration section above.

There are two ways to configure the Docker environment:

1. Using cli arguments directly in the config:

json
{
"mcpServers": {
"mcp-atlassian": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"mcp/atlassian",
"--confluence-url=https://your-company.atlassian.net/wiki",
"[email protected]",
"--confluence-token=your_api_token",
"--jira-url=https://your-company.atlassian.net",
"[email protected]",
"--jira-token=your_api_token"
]
}
}
}

2. Using an environment file:
json
{
"mcpServers": {
"mcp-atlassian": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--env-file",
"/path/to/your/.env",
"mcp/atlassian"
]
}
}
}
</details>

1. Open Cursor Settings
2. Navigate to Features > MCP Servers
3. Click Add new MCP server

For stdio transport:

yaml
name: mcp-atlassian
type: command
command: uvx mcp-atlassian --confluence-url=https://your-company.atlassian.net/wiki [email protected] --confluence-token=your_api_token --jira-url=https://your-company.atlassian.net [email protected] --jira-token=your_api_token

Image

<details>
<summary>Server/Data Center Configuration</summary>

yaml
name: mcp-atlassian
type: command
command: 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
</details>

For SSE transport, first start the server:

bash
uvx mcp-atlassian ... --transport sse --port 8000

Then configure in Cursor:
yaml
name: mcp-atlassian
type: sse
Server URL: http://localhost:8000/sse

Image

If you've cloned the repository and want to run a local version:

json
{
"mcpServers": {
"mcp-atlassian": {
"command": "uv",
"args": [
"--directory", "/path/to/your/mcp-atlassian",
"run", "mcp-atlassian",
"--confluence-url=https://your-domain.atlassian.net/wiki",
"[email protected]",
"--confluence-token=your_api_token",
"--jira-url=https://your-domain.atlassian.net",
"[email protected]",
"--jira-token=your_api_token"
]
}
}
}
```

npx @modelcontextprotocol/inspector uvx mcp-atlassian ...

confluence_search

Search Confluence content using CQL

confluence_get_page

Get content of a specific Confluence page

confluence_get_page_children

Get child pages of a specific Confluence page

confluence_get_page_ancestors

Get parent pages of a specific Confluence page

confluence_get_comments

Get comments for a specific Confluence page

confluence_create_page

Create a new Confluence page

confluence_update_page

Update an existing Confluence page

confluence_delete_page

Delete an existing Confluence page

jira_get_issue

Get details of a specific Jira issue

jira_search

Search Jira issues using JQL

jira_get_project_issues

Get all issues for a specific Jira project

jira_create_issue

Create a new issue in Jira

jira_update_issue

Update an existing Jira issue

jira_delete_issue

Delete an existing Jira issue

jira_get_transitions

Get available status transitions for a Jira issue

jira_transition_issue

Transition a Jira issue to a new status

jira_add_worklog

Add a worklog entry to a Jira issue

jira_get_worklog

Get worklog entries for a Jira issue

jira_link_to_epic

Link an issue to an Epic

jira_get_epic_issues

Get all issues linked to a specific Epic

| Tool | Description |
|------|-------------|
| confluence_search | Search Confluence content using CQL |
| confluence_get_page | Get content of a specific Confluence page |
| confluence_get_page_children | Get child pages of a specific Confluence page |
| confluence_get_page_ancestors | Get parent pages of a specific Confluence page |
| confluence_get_comments | Get comments for a specific Confluence page |
| confluence_create_page | Create a new Confluence page |
| confluence_update_page | Update an existing Confluence page |
| confluence_delete_page | Delete an existing Confluence page |
| jira_get_issue | Get details of a specific Jira issue |
| jira_search | Search Jira issues using JQL |
| jira_get_project_issues | Get all issues for a specific Jira project |
| jira_create_issue | Create a new issue in Jira |
| jira_update_issue | Update an existing Jira issue |
| jira_delete_issue | Delete an existing Jira issue |
| jira_get_transitions | Get available status transitions for a Jira issue |
| jira_transition_issue | Transition a Jira issue to a new status |
| jira_add_worklog | Add a worklog entry to a Jira issue |
| jira_get_worklog | Get worklog entries for a Jira issue |
| jira_link_to_epic | Link an issue to an Epic |
| jira_get_epic_issues | Get all issues linked to a specific Epic |

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp atlassian": {
            "mcp-atlassian-sprint": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-atlassian-sprint": {
        "command": "uvx",
        "args": [
            "mcp-atlassian"
        ]
    }
}

Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira). This integration supports both Atlassian Cloud and Server/Data Center deployments.

Feature Demo

Jira Demo

<details>
<summary>Confluence Demo</summary>

Confluence Demo
</details>

Compatibility

| Product | Deployment Type | Support Status |
|---------|----------------|-----------------------------|
| Confluence | Cloud | ✅ Fully supported |
| Confluence | Server/Data Center | ✅ Supported (version 7.9+) |
| Jira | Cloud | ✅ Fully supported |
| Jira | Server/Data Center | ✅ Supported (version 8.14+) |

Setup Guide

1. Authentication Setup

First, generate the necessary authentication tokens:

For Atlassian Cloud
1. Go to https://id.atlassian.com/manage-profile/security/api-tokens 2. Click Create API token, name it 3. Copy the token immediately
For Server/Data Center
1. Go to your profile (avatar) → Profile → Personal Access Tokens 2. Click Create token, name it, set expiry 3. Copy the token immediately

2. Installation

Choose one of these installation methods:

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.