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

Task	Tool	Notes
Read pages	MCP tools	confluence_getContent, confluence_searchContent
Small text-only uploads (<10KB)	MCP tools	confluence_createContent, confluence_updateContent
Large documents (>10KB)	upload_confluence_v2.py	REST API, no size limits
Documents with images	upload_confluence_v2.py	Handles attachments automatically
Download pages to Markdown	download_confluence.py	Converts macros, downloads attachments
Download page to Markdown (lightweight)	download_long_page.py	Stdlib + html2text only, no heavy deps

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/scripts/upload_confluence_v2.py \
    document.md --id 780369923

# Dry-run preview
python3 ~/.claude/skills/confluence/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/scripts/download_confluence.py 123456789

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

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

See Downloading Guide for details.

Upload Pages 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:

python3 ~/.claude/skills/confluence/scripts/upload_confluence_v2.py \
    document.md --id PAGE_ID

See Image Handling Best Practices for details.

Search Confluence

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

Create/Update Pages (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"
})

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

Markdown	Wiki Markup
# Heading	h1. Heading
**bold**	*bold*
*italic*	_italic_
`code`	{{code}}
[text](url)	`[text

Reference Documentation

Detailed guides in the references/ directory:

Guide	Purpose
Wiki Markup Reference	Complete syntax for Confluence Wiki Markup
Conversion Guide	Markdown to Wiki Markup conversion rules
Storage Format	Confluence XML storage format details
Image Handling	Workflows for images, Mermaid, PlantUML
Troubleshooting	Common errors and solutions

Available MCP Tools

Tool	Description
confluence_getContent	Get content by ID
confluence_searchContent	Search with CQL
confluence_createContent	Create page/blogpost
confluence_updateContent	Update content (version REQUIRED)
confluence_searchSpace	Search spaces
confluence_deletePage	Delete page
confluence_getPageChildren	Get child pages
confluence_getLabels	Get labels
confluence_addLabel	Add label
confluence_getComments	Get comments

Utility Scripts

Script	Purpose
scripts/upload_confluence_v2.py	Upload large documents with images
scripts/download_confluence.py	Download pages to Markdown
scripts/convert_markdown_to_wiki.py	Convert Markdown to Wiki Markup
scripts/render_mermaid.py	Render Mermaid diagrams
scripts/download_long_page.py	Lightweight single-page downloader (stdlib + html2text)

---

Version: 3.1.0 | Last Updated: 2026-03-01