luagam/agent-delivery/aio-confluence

Confluence

Source: nguyenvanduocit/confluence-mcp

Environment

• Go: !which go 2>/dev/null || echo "NOT INSTALLED"
• confluence-mcp: !which confluence-mcp 2>/dev/null || echo "NOT INSTALLED"
• confluence-cli: !which confluence-cli 2>/dev/null || echo "NOT INSTALLED"
• ATLASSIAN_HOST: !echo ${ATLASSIAN_HOST:-NOT SET}
• ATLASSIAN_EMAIL: !echo ${ATLASSIAN_EMAIL:-NOT SET}
• ATLASSIAN_TOKEN: ![ -n "$ATLASSIAN_TOKEN" ] && echo "SET" || echo "NOT SET"
• MCP configured: !cat .mcp.json 2>/dev/null | grep -q confluence && echo "YES" || echo "NO"

Install (skip if already installed above)

# Via Go
go install github.com/nguyenvanduocit/confluence-mcp@latest
go install github.com/nguyenvanduocit/confluence-mcp/cmd/confluence-cli@latest
 
# Or via Homebrew
brew install nguyenvanduocit/tap/confluence-mcp

Env vars needed: ATLASSIAN_HOST, ATLASSIAN_EMAIL, ATLASSIAN_TOKEN (get token from https://id.atlassian.com/manage-profile/security/api-tokens).

MCP config (.mcp.json):

{
  "mcpServers": {
    "confluence": {
      "command": "confluence-mcp",
      "env": {
        "ATLASSIAN_HOST": "",
        "ATLASSIAN_EMAIL": "",
        "ATLASSIAN_TOKEN": ""
      }
    }
  }
}

Restart Claude Code after adding MCP config.

MCP Tools (prefix: confluence_)

Note: update_page requires version = current version + 1. Get current from get_page first.

CLI (fallback if MCP not configured)

confluence-cli search-page --query "CQL" --env .env
confluence-cli get-page --page-id 12345 --env .env
confluence-cli create-page --space-key DEV --title "Title" --content "<p>HTML</p>" --env .env
confluence-cli update-page --page-id 12345 --title "Title" --content "<p>HTML</p>" --version 2 --env .env
confluence-cli get-comments --page-id 12345 --env .env
confluence-cli list-spaces --env .env

Flags: --env (path to .env file), --output (text or json).

Workflows

Find and update: search → get_page (note version) → update_page (version+1) Doc hierarchy: create parent page → create children with parent_id