MCP Atlassian

by final-il

437 downloads Not rated yet MIT license

GitHub

About

MCP Atlassian is a Model Context Protocol (MCP) server for Atlassian products—Confluence and Jira. It supports both Cloud and Server/Data Center deployments, allowing AI assistants to interact with Confluence pages and Jira issues.

Details

License: MIT license

Explore

Jira Demo

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

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

</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:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
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.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

From the repository

First, generate the necessary authentication tokens for Confluence & Jira:

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 uvx - Confluence with Basic Auth (older servers)</summary>

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

</details>
<details>

<summary>Using uvx - Confluence only</summary>

</details>
<details>

<summary>Using uvx - Jira only</summary>

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

</details>
<details>

<summary>Using pip</summary>
> Note: Examples below use 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": "mcp-atlassian",
"args": [
"--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 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 (or directly to MCP)

3. Click + Add new global MCP server
This will create or edit the ~/.cursor/mcp.json file with your MCP server configuration.

For Cloud:



<details>

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

</details>

For SSE transport, first start the server with its configuration provided via command-line arguments or server-side environment variables (e.g., from a .env file):

bash

uvx mcp-atlassian --transport sse --port 9000 \
--confluence-url https://your-company.atlassian.net/wiki \
--confluence-username [email protected] \
--confluence-token your_api_token \
--jira-url https://your-company.atlassian.net \
--jira-username [email protected] \
--jira-token your_api_token



Then configure only the URL in Cursor's ~/.cursor/mcp.json:

json
{
"mcpServers": {
"mcp-atlassian-sse": {
"url": "http://localhost:9000/sse"
}
}
}

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

For Cloud:

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

`confluence_attach_content`

Attach content to a 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_get_epic_issues`

Get all issues linked to a specific Epic

`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_comment`

Add a comment to a Jira issue

`jira_add_worklog`

Add a worklog entry to a Jira issue

`jira_get_worklog`

Get worklog entries for a Jira issue

`jira_download_attachments`

Download attachments from a Jira issue

`jira_link_to_epic`

Link an issue to an Epic

`jira_get_agile_boards`

Get Jira agile boards by name, project key, or type

`jira_get_board_issues`

Get all issues linked to a specific board

`jira_get_sprints_from_board`

Get Jira sprints from board by state

`jira_get_sprint_issues`

Get Jira issues from sprint

| 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 |
| confluence_attach_content | Attach content to a 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_get_epic_issues | Get all issues linked to a specific Epic |
| 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_comment | Add a comment to a Jira issue |
| jira_add_worklog | Add a worklog entry to a Jira issue |
| jira_get_worklog | Get worklog entries for a Jira issue |
| jira_download_attachments | Download attachments from a Jira issue |
| jira_link_to_epic | Link an issue to an Epic |
| jira_get_agile_boards | Get Jira agile boards by name, project key, or type |
| jira_get_board_issues | Get all issues linked to a specific board |
| jira_get_sprints_from_board | Get Jira sprints from board by state |
| jira_get_sprint_issues | Get Jira issues from sprint |

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "mcp atlassian": {
            "jira-mcp-server-final-il": {
                "command": "uvx",
                "args": [
                    "mcp-atlassian"
                ]
            }
        }
    }
}

McpServers

{
    "jira-mcp-server-final-il": {
        "command": "uvx",
        "args": [
            "mcp-atlassian"
        ]
    }
}

PyPI Version
PyPI - Downloads

License

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

Feature Demo

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

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

</details>

Compatibility

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

Setup Guide

1. Authentication Setup

First, generate the necessary authentication tokens for Confluence & Jira:

For 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

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

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

confluence_search

confluence_get_page

confluence_get_page_children

confluence_get_page_ancestors

confluence_get_comments

confluence_create_page

confluence_update_page

confluence_delete_page

confluence_attach_content

jira_get_issue

jira_search

jira_get_project_issues

jira_get_epic_issues

jira_create_issue

jira_update_issue

jira_delete_issue

jira_get_transitions

jira_transition_issue

jira_add_comment

jira_add_worklog

jira_get_worklog

jira_download_attachments

jira_link_to_epic

jira_get_agile_boards

jira_get_board_issues

jira_get_sprints_from_board

jira_get_sprint_issues

Claude Desktop / Cursor

McpServers

Feature Demo

Compatibility

Setup Guide

1. Authentication Setup

For Cloud

For Server/Data Center

2. Installation

More like this

Sentry

Github

Git

GitLab

`confluence_search`

`confluence_get_page`

`confluence_get_page_children`

`confluence_get_page_ancestors`

`confluence_get_comments`

`confluence_create_page`

`confluence_update_page`

`confluence_delete_page`

`confluence_attach_content`

`jira_get_issue`

`jira_search`

`jira_get_project_issues`

`jira_get_epic_issues`

`jira_create_issue`

`jira_update_issue`

`jira_delete_issue`

`jira_get_transitions`

`jira_transition_issue`

`jira_add_comment`

`jira_add_worklog`

`jira_get_worklog`

`jira_download_attachments`

`jira_link_to_epic`

`jira_get_agile_boards`

`jira_get_board_issues`

`jira_get_sprints_from_board`

`jira_get_sprint_issues`