Confluence Data Center Management Skill

Manage Confluence Data Center documentation through Claude Code: download pages to Markdown, upload large documents with images, convert between formats, and integrate Mermaid/PlantUML diagrams.

Table of Contents

• Quick Decision Matrix
• MCP Size Limits
• Prerequisites
• Core Workflows
• Reference Documentation

Quick Decision Matrix

MCP Size Limits

MCP tools have size limits (10-20KB) for uploads. For large documents or pages with images, use the REST API via upload_confluence_v2.py:

# Upload large document
python3 ~/.claude/skills/confluence-dc/scripts/upload_confluence_v2.py \
    document.md --id 780369923

# Dry-run preview
python3 ~/.claude/skills/confluence-dc/scripts/upload_confluence_v2.py \
    document.md --id 780369923 --dry-run

MCP works for reading pages but not for uploading large content.

Prerequisites

Required

• Confluence Data Center MCP Server (compasify-confluence-dc) with PAT-based authentication.
• npm package: @compasify/confluence-dc

Optional

• Mermaid CLI: Diagram rendering (npm install -g @mermaid-js/mermaid-cli)

Core Workflows

Download Pages to Markdown

# Single page
python3 ~/.claude/skills/confluence-dc/scripts/download_confluence.py 123456789

# With child pages
python3 ~/.claude/skills/confluence-dc/scripts/download_confluence.py --download-children 123456789

# Custom output directory
python3 ~/.claude/skills/confluence-dc/scripts/download_confluence.py --output-dir ./docs 123456789

See Downloading Guide for details.

Upload Pages/Blogposts with Images

1. Convert diagrams to images first using design-doc-mermaid or plantuml skills
2. Reference images with standard markdown: ![Description](./images/diagram.png)
3. Upload via REST API:

# Upload as page (default)
python3 ~/.claude/skills/confluence-dc/scripts/upload_confluence_v2.py \
    document.md --id PAGE_ID

# Upload as blogpost
python3 ~/.claude/skills/confluence-dc/scripts/upload_confluence_v2.py \
    document.md --space ARCP --type blogpost

See Image Handling Best Practices for details.

Search Confluence

confluence_searchContent({
  cql: 'space = "DEV" AND text ~ "API"',
  limit: 10
})

Create/Update Pages & Blogposts (Small Documents)

Note: Content format for these tools is Confluence storage format (XML-based), not wiki markup.

// Create page
confluence_createContent({
  spaceKey: "DEV",
  title: "API Documentation",
  content: "<h1>Overview</h1><p>Content here...</p>",
  type: "page"
})

// Create blogpost
confluence_createContent({
  spaceKey: "DEV",
  title: "Release Notes v2.0",
  content: "<h1>What's New</h1><p>Content here...</p>",
  type: "blogpost"
})

// Update page
// CRITICAL: updateContent requires explicit version number (fetch current + increment)
confluence_updateContent({
  contentId: "123456789",
  title: "Updated Title",
  content: "<h1>New Content</h1><p>Updated content...</p>",
  version: 2,
  versionComment: "Updated via Claude Code"
})

DC-Specific Notes

• Authentication: Uses Personal Access Token (PAT). Ensure CONFLUENCE_API_TOKEN is set.
• SSL: If using self-signed certificates, ensure appropriate environment variables are configured to allow the connection.
• Code Blocks: In Confluence Data Center, json language is NOT supported in code blocks. Use javascript instead.

Convert Between Formats

See Conversion Guide for the complete conversion matrix.

Quick reference:

Reference Documentation

Detailed guides in the references/ directory:

Available MCP Tools

Utility Scripts

Version: 3.2.0 | Last Updated: 2026-03-02