Confluence Datacenter

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:

Text with 

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

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: mfmezger
• Source: mfmezger/aiagent_dotfiles
• License: MIT

Install and usage instructions live in the source repository linked above.