# Confluence Datacenter

> 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.

- **Type:** Skill
- **Install:** `agentstack add skill-mfmezger-ai-agent-dotfiles-confluence-datacenter`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [mfmezger](https://agentstack.voostack.com/s/mfmezger)
- **Installs:** 0
- **Category:** [Productivity](https://agentstack.voostack.com/c/productivity)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [mfmezger](https://github.com/mfmezger)
- **Source:** https://github.com/mfmezger/ai_agent_dotfiles/tree/main/shared/skills/confluence-datacenter

## Install

```sh
agentstack add skill-mfmezger-ai-agent-dotfiles-confluence-datacenter
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

```bash
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

```bash
# 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)

```bash
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

```bash
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

```bash
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

```bash
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

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

### List Spaces

```bash
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

```bash
# 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

```bash
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

```bash
# 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:

```xml
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](https://github.com/mfmezger)
- **Source:** [mfmezger/ai_agent_dotfiles](https://github.com/mfmezger/ai_agent_dotfiles)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-mfmezger-ai-agent-dotfiles-confluence-datacenter
- Seller: https://agentstack.voostack.com/s/mfmezger
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.