confluence-datacenter

name	confluence-datacenter
description	This skill should be used when the user asks to "get Confluence page", "create Confluence page", "search Confluence", "update wiki page", or needs to interact with Confluence Data Center/Server instances.
version	0.1.0

Confluence Data Center

Interact with Confluence Data Center/Server instances via REST API.

Features

Command	Description
get	Get page content by ID or title
search	Search content using CQL
create	Create a new page
update	Update page content
delete	Delete a page
children	List child pages
spaces	List available spaces
attachments	List or upload attachments
export	Export page to different formats

Prerequisites

Environment variables (can be in .env file):

• CONFLUENCE_BASE_URL - Your Confluence instance URL (e.g., https://confluence.company.com)
• CONFLUENCE_PAT - Personal Access Token (preferred)

OR for basic auth:

• CONFLUENCE_BASE_URL - Your Confluence instance URL
• CONFLUENCE_USERNAME - Your username
• CONFLUENCE_PASSWORD - Your password

Creating a Personal Access Token

1. Go to your Confluence profile (click avatar → Settings)
2. Navigate to Personal Access Tokens
3. Click "Create token"
4. Give it a name and set expiry
5. Copy the token to CONFLUENCE_PAT

Usage

uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py COMMAND [OPTIONS]

Commands

Get Page

# By page ID
uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py get 12345

# By title and space
uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py get --space DEV --title "Getting Started"

Options:

• --format html|storage|markdown - Output format (default: markdown)
• --json - Output full JSON response

Search Content (CQL)

uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py search "space = DEV AND title ~ 'API'"

Options:

• --max N - Maximum results (default: 25)
• --type page|blogpost|comment - Content type filter
• --json - Output as JSON

Create Page

uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py create \
  --space DEV \
  --title "New Page Title" \
  --body "Page content in **markdown** or HTML"

Options:

• --space KEY - Space key (required)
• --title TEXT - Page title (required)
• --body TEXT - Page content (required)
• --body-file PATH - Read body from file instead
• --parent ID - Parent page ID
• --format markdown|html|storage - Body format (default: markdown)

Update Page

uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py update 12345 \
  --body "Updated content"

Options:

• --title TEXT - New title
• --body TEXT - New content
• --body-file PATH - Read body from file
• --format markdown|html|storage - Body format
• --minor - Mark as minor edit

Delete Page

uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py delete 12345

Options:

• --force - Skip confirmation

List Child Pages

uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py children 12345

List Spaces

uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py spaces

Options:

• --type global|personal - Filter by space type

Attachments

# List attachments
uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py attachments 12345

# Upload attachment
uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py attachments 12345 \
  --upload /path/to/file.pdf

Export Page

uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py export 12345 \
  --format pdf \
  --output ./exported-page.pdf

Options:

• --format pdf|word|markdown - Export format
• --output PATH - Output file path

Examples

# Get a page as markdown
uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py get 12345

# Search for pages about API in DEV space
uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py search \
  "space = DEV AND type = page AND text ~ 'API documentation'"

# Create page from markdown file
uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py create \
  --space DEV \
  --title "API Reference" \
  --body-file ./api-docs.md \
  --format markdown

# Create child page
uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py create \
  --space DEV \
  --title "Sub Page" \
  --body "Content here" \
  --parent 12345

# Update page with file content
uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py update 12345 \
  --body-file ./updated-docs.md \
  --format markdown

# Export page to PDF
uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py export 12345 \
  --format pdf \
  --output ./docs.pdf

# Upload diagram to page
uvx --with requests --with python-dotenv --with typer --with rich --with markitdown \
  python ~/.claude/skills/confluence-datacenter/scripts/confluence.py attachments 12345 \
  --upload ./architecture.png

Content Formats

Markdown (recommended)

Write content in standard Markdown. The skill converts to Confluence storage format.

HTML

Standard HTML that Confluence will render.

Storage Format

Confluence's native XHTML-based storage format with macros:

<p>Text with <ac:link><ri:page ri:content-title="Other Page"/></ac:link></p>

Output

• Default output is human-readable formatted text
• Page content defaults to Markdown format
• Use --json flag for machine-readable JSON output
• URLs are included for easy navigation

API Version

This skill uses Confluence REST API (/rest/api/), compatible with:

• Confluence Data Center 6.x and later
• Confluence Server 6.x and later