atlassian cloud.com
atlassian cloud.com logo

Atlassian Cloud

Access Confluence pages and Jira issues via Atlassian API.

Created byApr 22, 2025

MCP Atlassian

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

Example Usage

Ask your AI assistant to:
  • ** Automatic Jira Updates** - "Update Jira from our meeting notes"
  • ** AI-Powered Confluence Search** - "Find our OKR guide in Confluence and summarize it"
  • ** Smart Jira Issue Filtering** - "Show me urgent bugs in PROJ project from last week"
  • ** Content Creation & Management** - "Create a tech design doc for XYZ feature"

Feature Demo

Compatibility

[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]

Quick Start 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
  1. Click Create API token, name it
  1. Copy the token immediately

For Server/Data Center

  1. Go to your profile (avatar) Profile Personal Access Tokens
  1. Click Create token, name it, set expiry
  1. Copy the token immediately

2. Installation

MCP Atlassian is distributed as a Docker image. This is the recommended way to run the server, especially for IDE integration. Ensure you have Docker installed.

IDE Integration

MCP Atlassian is designed to be used with AI assistants through IDE integration.
[!TIP] To apply the configuration in Claude Desktop:Method 1 (Recommended): Click hamburger menu ( ) > Settings > Developer > "Edit Config" buttonMethod 2: Locate and edit the configuration file directly:For Cursor: Open Settings Features MCP Servers + Add new global MCP server

Configuration Methods

There are two main approaches to configure the Docker container:
  1. Passing Variables Directly (shown in examples below)
  1. Using an Environment File with --env-file flag (shown in collapsible sections)
[!NOTE] Common environment variables include:See the .env.example file for all available options.

Configuration Examples

Method 1 (Passing Variables Directly):
For Server/Data Center deployments, use direct variable passing:
[!NOTE] Set CONFLUENCE_SSL_VERIFY and JIRA_SSL_VERIFY to "false" only if you have self-signed certificates.
For Confluence Cloud only:
For Confluence Server/DC, use:
For Jira Cloud only:
For Jira Server/DC, use:

SSE Transport Configuration

  1. Start the server manually in a terminal:
  1. Configure your IDE to connect to the running server via its URL:

Tools

Confluence Tools

  • confluence_search: Search Confluence content using CQL
  • confluence_get_page: Get content of a specific page
  • confluence_create_page: Create a new page
  • confluence_update_page: Update an existing page

Jira Tools

  • jira_get_issue: Get details of a specific issue
  • jira_search: Search issues using JQL
  • jira_create_issue: Create a new issue
  • jira_update_issue: Update an existing issue
  • jira_transition_issue: Transition an issue to a new status
  • jira_add_comment: Add a comment to an issue
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]

Troubleshooting & Debugging

Common Issues

  • Authentication Failures:
  • SSL Certificate Issues: If using Server/Data Center and encounter SSL errors, set CONFLUENCE_SSL_VERIFY=false or JIRA_SSL_VERIFY=false
  • Permission Errors: Ensure your Atlassian account has sufficient permissions to access the spaces/projects

Debugging Tools

Security

  • Never share API tokens
  • Keep .env files secure and private
  • See SECURITY.md for best practices

Contributing

We welcome contributions to MCP Atlassian! If you'd like to contribute:
  1. Check out our CONTRIBUTING.md guide for detailed development setup instructions.
  1. Make changes and submit a pull request.
We use pre-commit hooks for code quality and follow semantic versioning for releases.

License

Licensed under MIT - see LICENSE file. This is not an official Atlassian product.

MCP Atlassian

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

Example Usage

Ask your AI assistant to:
  • ** Automatic Jira Updates** - "Update Jira from our meeting notes"
  • ** AI-Powered Confluence Search** - "Find our OKR guide in Confluence and summarize it"
  • ** Smart Jira Issue Filtering** - "Show me urgent bugs in PROJ project from last week"
  • ** Content Creation & Management** - "Create a tech design doc for XYZ feature"

Feature Demo

Compatibility

[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]

Quick Start 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
  1. Click Create API token, name it
  1. Copy the token immediately

For Server/Data Center

  1. Go to your profile (avatar) Profile Personal Access Tokens
  1. Click Create token, name it, set expiry
  1. Copy the token immediately

2. Installation

MCP Atlassian is distributed as a Docker image. This is the recommended way to run the server, especially for IDE integration. Ensure you have Docker installed.

IDE Integration

MCP Atlassian is designed to be used with AI assistants through IDE integration.
[!TIP] To apply the configuration in Claude Desktop:Method 1 (Recommended): Click hamburger menu ( ) > Settings > Developer > "Edit Config" buttonMethod 2: Locate and edit the configuration file directly:For Cursor: Open Settings Features MCP Servers + Add new global MCP server

Configuration Methods

There are two main approaches to configure the Docker container:
  1. Passing Variables Directly (shown in examples below)
  1. Using an Environment File with --env-file flag (shown in collapsible sections)
[!NOTE] Common environment variables include:See the .env.example file for all available options.

Configuration Examples

Method 1 (Passing Variables Directly):
For Server/Data Center deployments, use direct variable passing:
[!NOTE] Set CONFLUENCE_SSL_VERIFY and JIRA_SSL_VERIFY to "false" only if you have self-signed certificates.
For Confluence Cloud only:
For Confluence Server/DC, use:
For Jira Cloud only:
For Jira Server/DC, use:

SSE Transport Configuration

  1. Start the server manually in a terminal:
  1. Configure your IDE to connect to the running server via its URL:

Tools

Confluence Tools

  • confluence_search: Search Confluence content using CQL
  • confluence_get_page: Get content of a specific page
  • confluence_create_page: Create a new page
  • confluence_update_page: Update an existing page

Jira Tools

  • jira_get_issue: Get details of a specific issue
  • jira_search: Search issues using JQL
  • jira_create_issue: Create a new issue
  • jira_update_issue: Update an existing issue
  • jira_transition_issue: Transition an issue to a new status
  • jira_add_comment: Add a comment to an issue
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]
[object Object]

Troubleshooting & Debugging

Common Issues

  • Authentication Failures:
  • SSL Certificate Issues: If using Server/Data Center and encounter SSL errors, set CONFLUENCE_SSL_VERIFY=false or JIRA_SSL_VERIFY=false
  • Permission Errors: Ensure your Atlassian account has sufficient permissions to access the spaces/projects

Debugging Tools

Security

  • Never share API tokens
  • Keep .env files secure and private
  • See SECURITY.md for best practices

Contributing

We welcome contributions to MCP Atlassian! If you'd like to contribute:
  1. Check out our CONTRIBUTING.md guide for detailed development setup instructions.
  1. Make changes and submit a pull request.
We use pre-commit hooks for code quality and follow semantic versioning for releases.

License

Licensed under MIT - see LICENSE file. This is not an official Atlassian product.