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
-
Convert diagrams to images first using design-doc-mermaid or plantuml skills
-
Reference images with standard markdown:
-
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
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