Confluence MCP Server

Model Context Protocol (MCP) server that gives GitHub Copilot full read/write access to your Confluence instance (Cloud, Server, or Data Center).

Works with any Confluence instance — Atlassian Cloud (*.atlassian.net), self-hosted Server, or Data Center.

Configuration

You need two things before running setup:

setup.ps1 will prompt you for both interactively. You can also pass them as arguments:

.\setup.ps1 -Url "https://yourcompany.atlassian.net" -Pat "YOUR_TOKEN"

Related MCP server: MCP Atlassian Server

Quick Start

1. Create a Personal Access Token

In your Confluence, go to Profile → Personal Access Tokens and create a new token.

• Atlassian Cloud: https://yourcompany.atlassian.net → Profile → Security → API tokens

• Server / Data Center: https://your-confluence/plugins/personalaccesstokens/usertokens.action

2. Run Setup

cd confluence-mcp
.\setup.ps1

The script will:

• Prompt for your Confluence URL and PAT (or pass via -Url / -Pat flags)

• Create a Python virtual environment

• Install dependencies (mcp, httpx)

• Validate your credentials against your Confluence instance

• Auto-write the MCP config into VS Code

3. Add to VS Code

Open Settings JSON (Ctrl+Shift+P → Preferences: Open User Settings (JSON)) and add the MCP server config printed by the setup script:

{
  "mcp": {
    "servers": {
      "confluence": {
        "command": "C:\\path\\to\\.venv\\Scripts\\python.exe",
        "args": ["C:\\path\\to\\server.py"],
        "env": {
          "CONFLUENCE_URL": "https://your-confluence.company.com",
          "CONFLUENCE_PAT": "YOUR_TOKEN_HERE"
        }
      }
    }
  }
}

4. Verify

Ctrl+Shift+P → MCP: List Servers → you should see confluence with a green status.

Available Tools

Read Tools (6)

Write Tools (6)

Crawl & Navigation Tools (2)

Attachment Tools (2)

Diagram Tools (4)

Diagram features: Topology-aware layout, orthogonal edge routing with collision avoidance, embedded GCP legacy blue icons (225), SAP BTP and Azure support. No generic shapes.

Usage Examples in Copilot Chat

@workspace Search Confluence for architecture docs
@workspace Read the page with ID 504270225
@workspace Crawl across the SAP space and find everything about GCP migration
@workspace Show me the page tree under page ID 479570414
@workspace Create a GCP architecture diagram for our data pipeline on page 504270225
@workspace List the available GCP icons for diagrams
@workspace Upload the CSV report to page 685316626
@workspace Create a new child page under page 479570414

CQL Quick Reference

Confluence Query Language (CQL) powers the search_confluence tool:

-- Full-text search
text ~ "submission letter"

-- Pages in a specific space
space = "SAP" AND type = "page"

-- Recently modified
lastModified > "2025-06-01" AND space = "SAP"

-- By creator
creator = currentUser()

-- By label
label = "gcp" AND label = "slg"

-- Title match
title ~ "Architecture"

Project Structure

confluence-mcp/
├── server.py          # MCP server (20 tools)
├── icon_data.py       # 225 GCP legacy blue icons (base64 PNG)
├── setup.ps1          # One-click setup script
├── requirements.txt   # Python dependencies
├── docs/index.html    # Documentation site
└── README.md          # This file

Requirements

• Python 3.10+

• VS Code with GitHub Copilot Chat

• A Confluence Personal Access Token (create one in your Confluence profile settings)

Troubleshooting

Server not showing in MCP: List Servers?

1. Ctrl+Shift+P → MCP: Reset All Cached MCP Servers

2. Reload VS Code (Ctrl+Shift+P → Developer: Reload Window)

3. Check that the Python path in your config points to the .venv Python executable

Connection errors?

• Ensure you're on the correct network (VPN if needed for self-hosted Confluence)

• Verify your PAT hasn't expired (check your Confluence profile → Personal Access Tokens)

SSL errors?

• The server uses verify=False for corporate proxy/SSL inspection — this is expected behavior

Open source — contributions welcome