mcp-atlassian

MCP server to interact with Atlassian products (currently supporting Confluence).

Features

Tools

• search_confluence: Search Confluence content using natural language
• get_page_content: Get content of a specific Confluence page
• get_page_comments: Get comments for a specific page

Example prompts

• "Search for all documentation related to authentication and summarize the key points"
• "Get the content of the onboarding guide and create a checklist from it"
• "Find all comments on the project requirements page and highlight any concerns raised"

Installation

# Using pip
pip install mcp-atlassian

# Or using uv (recommended)
uv pip install mcp-atlassian

Setup

Requirements

Create a .env file with:

CONFLUENCE_CLOUD_URL=your_confluence_url
CONFLUENCE_CLOUD_USER=your_username
CONFLUENCE_CLOUD_TOKEN=your_api_token

To get an API token:

1. Log in to https://id.atlassian.com/manage-profile/security/api-tokens
2. Click Create API token
3. Enter a memorable Label for your token and click Create
4. Click Copy to clipboard to save your token securely

Claude Desktop Configuration

Location:

• MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuration

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-atlassian",
        "run",
        "mcp-atlassian"
      ],
      "env": {
        "CONFLUENCE_CLOUD_URL": "your_confluence_url",
        "CONFLUENCE_CLOUD_USER": "your_username",
        "CONFLUENCE_CLOUD_TOKEN": "your_api_token"
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "CONFLUENCE_CLOUD_URL": "your_confluence_url",
        "CONFLUENCE_CLOUD_USER": "your_username",
        "CONFLUENCE_CLOUD_TOKEN": "your_api_token"
      }
    }
  }
}

Development

Building

# Install dependencies
uv sync

# Build package
uv build

# Publish to PyPI
uv publish

Debugging

Use MCP Inspector:

npx @modelcontextprotocol/inspector mcp-atlassian

View logs:

tail -n 20 -f ~/Library/Logs/Claude/mcp-server-mcp-atlassian.log

Todo

• Jira integration

Configuration

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uv",
      "args": [
        "--directory",
        "<dir_to>/mcp-atlassian",
        "run",
        "mcp-atlassian"
      ],
      "env": {
        "CONFLUENCE_CLOUD_URL": "your_confluence_url",
        "CONFLUENCE_CLOUD_USER": "your_username",
        "CONFLUENCE_CLOUD_TOKEN": "your_api_token"
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "CONFLUENCE_CLOUD_URL": "your_confluence_url",
        "CONFLUENCE_CLOUD_USER": "your_username",
        "CONFLUENCE_CLOUD_TOKEN": "your_api_token"
      }
    }
  }
}

Legal & Security

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

Security

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

For security issues, please email [security contact].