Open Skills Logo
Open Skills

confluence-automation

Automate Confluence page creation, content search, space management, labels, and hierarchy navigation via Rube MCP (Composio). Always search tools first for current schemas.

View Source
name:confluence-automationdescription:"Automate Confluence page creation, content search, space management, labels, and hierarchy navigation via Rube MCP (Composio). Always search tools first for current schemas."requires:mcp:[rube]

Confluence Automation via Rube MCP

Automate Confluence operations including page creation and updates, content search with CQL, space management, label tagging, and page hierarchy navigation through Composio's Confluence toolkit.

Prerequisites

  • Rube MCP must be connected (RUBE_SEARCH_TOOLS available)

  • Active Confluence connection via RUBE_MANAGE_CONNECTIONS with toolkit confluence

  • Always call RUBE_SEARCH_TOOLS first to get current tool schemas

    • Setup

    Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.


  • Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds

  • Call RUBE_MANAGE_CONNECTIONS with toolkit confluence

  • If connection is not ACTIVE, follow the returned auth link to complete Confluence OAuth

  • Confirm connection status shows ACTIVE before running any workflows

    • Core Workflows

    1. Create and Update Pages

    When to use: User wants to create new documentation or update existing Confluence pages

    Tool sequence:

  • CONFLUENCE_GET_SPACES - List spaces to find the target space ID [Prerequisite]

  • CONFLUENCE_SEARCH_CONTENT - Find existing page to avoid duplicates or locate parent [Optional]

  • CONFLUENCE_GET_PAGE_BY_ID - Get current page content and version number before updating [Prerequisite for updates]

  • CONFLUENCE_CREATE_PAGE - Create a new page in a space [Required for creation]

  • CONFLUENCE_UPDATE_PAGE - Update an existing page with new content and incremented version [Required for updates]

  • CONFLUENCE_ADD_CONTENT_LABEL - Tag the page with labels after creation [Optional]

    • Key parameters:

  • spaceId: Space ID or key (e.g., "DOCS", "12345678") -- space keys are auto-converted to IDs

  • title: Page title (must be unique within a space)

  • parentId: Parent page ID for creating child pages; omit to place under space homepage

  • body.storage.value: HTML/XHTML content in Confluence storage format

  • body.storage.representation: Must be "storage" for create operations

  • version.number: For updates, must be current version + 1

  • version.message: Optional change description

    • Pitfalls:

  • Confluence enforces unique page titles per space; creating a page with a duplicate title will fail

  • UPDATE_PAGE requires version.number set to current version + 1; always fetch current version first with GET_PAGE_BY_ID

  • Content must be in Confluence storage format (XHTML), not plain text or Markdown

  • CREATE_PAGE uses body.storage.value while UPDATE_PAGE uses body.value with body.representation

  • GET_PAGE_BY_ID requires a numeric long ID, not a UUID or string

    • 2. Search Content

    When to use: User wants to find pages, blog posts, or content across Confluence

    Tool sequence:

  • CONFLUENCE_SEARCH_CONTENT - Keyword search with intelligent relevance ranking [Required]

  • CONFLUENCE_CQL_SEARCH - Advanced search using Confluence Query Language [Alternative]

  • CONFLUENCE_GET_PAGE_BY_ID - Hydrate full content for selected search results [Optional]

  • CONFLUENCE_GET_PAGES - Browse pages sorted by date when search relevance is weak [Fallback]

    • Key parameters for SEARCH_CONTENT:

  • query: Search text matched against page titles with intelligent ranking

  • spaceKey: Limit search to a specific space

  • limit: Max results (default 25, max 250)

  • start: Pagination offset (0-based)

    • Key parameters for CQL_SEARCH:

  • cql: CQL query string (e.g., text ~ "API docs" AND space = DOCS AND type = page)

  • expand: Comma-separated properties (e.g., content.space, content.body.storage)

  • excerpt: highlight, indexed, or none

  • limit: Max results (max 250; reduced to 25-50 when using body expansions)

    • CQL operators and fields:

  • Fields: text, title, label, space, type, creator, lastModified, created, ancestor

  • Operators: =, !=, ~ (contains), !~, >, <, >=, <=, IN, NOT IN

  • Functions: currentUser(), now("-7d"), now("-30d")

  • Example: title ~ "meeting" AND lastModified > now("-7d") ORDER BY lastModified DESC

    • Pitfalls:

  • CONFLUENCE_SEARCH_CONTENT fetches up to 300 pages and applies client-side filtering -- not a true full-text search

  • CONFLUENCE_CQL_SEARCH is the real full-text search; use text ~ "term" for content body search

  • HTTP 429 rate limits can occur; throttle to ~2 requests/second with backoff

  • Using body expansions in CQL_SEARCH may reduce max results to 25-50

  • Search indexing is not immediate; recently created pages may not appear

    • 3. Manage Spaces

    When to use: User wants to list, create, or inspect Confluence spaces

    Tool sequence:

  • CONFLUENCE_GET_SPACES - List all spaces with optional filtering [Required]

  • CONFLUENCE_GET_SPACE_BY_ID - Get detailed metadata for a specific space [Optional]

  • CONFLUENCE_CREATE_SPACE - Create a new space with key and name [Optional]

  • CONFLUENCE_GET_SPACE_PROPERTIES - Retrieve custom metadata stored as space properties [Optional]

  • CONFLUENCE_GET_SPACE_CONTENTS - List pages, blog posts, or attachments in a space [Optional]

  • CONFLUENCE_GET_LABELS_FOR_SPACE - List labels on a space [Optional]

    • Key parameters:

  • key: Space key -- alphanumeric only, no underscores or hyphens (e.g., DOCS, PROJECT1)

  • name: Human-readable space name

  • type: global or personal

  • status: current (active) or archived

  • spaceKey: For GET_SPACE_CONTENTS, filters by space key

  • id: Numeric space ID for GET_SPACE_BY_ID (NOT the space key)

    • Pitfalls:

  • Space keys must be alphanumeric only (no underscores, hyphens, or special characters)

  • GET_SPACE_BY_ID requires numeric space ID, not the space key; use GET_SPACES to find numeric IDs

  • Clickable space URLs may need assembly: join _links.webui (relative) with _links.base

  • Default pagination is 25; set limit explicitly (max 200 for spaces)

    • 4. Navigate Page Hierarchy and Labels

    When to use: User wants to explore page trees, child pages, ancestors, or manage labels

    Tool sequence:

  • CONFLUENCE_SEARCH_CONTENT - Find the target page ID [Prerequisite]

  • CONFLUENCE_GET_CHILD_PAGES - List direct children of a parent page [Required]

  • CONFLUENCE_GET_PAGE_ANCESTORS - Get the full ancestor chain for a page [Optional]

  • CONFLUENCE_GET_LABELS_FOR_PAGE - List labels on a specific page [Optional]

  • CONFLUENCE_ADD_CONTENT_LABEL - Add labels to a page [Optional]

  • CONFLUENCE_GET_LABELS_FOR_SPACE_CONTENT - List labels across all content in a space [Optional]

  • CONFLUENCE_GET_PAGE_VERSIONS - Audit edit history for a page [Optional]

    • Key parameters:

  • id: Page ID for child pages, ancestors, labels, and versions

  • cursor: Opaque pagination cursor for GET_CHILD_PAGES (from _links.next)

  • limit: Items per page (max 250 for child pages)

  • sort: Child page sort options: id, -id, created-date, -created-date, modified-date, -modified-date, child-position, -child-position

    • Pitfalls:

  • GET_CHILD_PAGES only returns direct children, not nested descendants; recurse for full tree

  • Pagination for GET_CHILD_PAGES uses cursor-based pagination (not start/limit)

  • Verify the correct page ID from search before using as parent; search can return similar titles

  • GET_PAGE_VERSIONS requires the page ID, not a version number

    • Common Patterns

    ID Resolution


    Always resolve human-readable names to IDs before operations:
  • Space key -> Space ID: CONFLUENCE_GET_SPACES with spaceKey filter, or CREATE_PAGE accepts space keys directly

  • Page title -> Page ID: CONFLUENCE_SEARCH_CONTENT with query param, then extract page ID

  • Space ID from URL: Extract numeric ID from Confluence URLs or use GET_SPACES

    • Pagination


    Confluence uses two pagination styles:
  • Offset-based (most endpoints): start (0-based offset) + limit (page size). Increment start by limit until fewer results than limit are returned.

  • Cursor-based (GET_CHILD_PAGES, GET_PAGES): Use the cursor from _links.next in the response. Continue until no next link is present.

    • Content Formatting


  • Pages use Confluence storage format (XHTML), not Markdown

  • Basic elements:

    ,

    -
    , , , ,
      ,
        ,

      2. Tables:
        / structure
      3. Macros: for code blocks, etc.

      4. Always wrap content in proper XHTML tags

        5. Known Pitfalls

        ID Formats


      5. Space IDs are numeric (e.g., 557060); space keys are short strings (e.g., DOCS)

      6. Page IDs are numeric long values for GET_PAGE_BY_ID; some tools accept UUID format

      7. GET_SPACE_BY_ID requires numeric ID, not the space key

      8. GET_PAGE_BY_ID takes an integer, not a string

        9. Rate Limits


      9. HTTP 429 can occur on search endpoints; honor Retry-After header

      10. Throttle to ~2 requests/second with exponential backoff and jitter

      11. Body expansion in CQL_SEARCH reduces result limits to 25-50

        12. Content Format


      12. Content must be Confluence storage format (XHTML), not Markdown or plain text

      13. Invalid XHTML will cause page creation/update to fail

      14. CREATE_PAGE nests body under body.storage.value; UPDATE_PAGE uses body.value + body.representation

        15. Version Conflicts


      15. Updates require exact next version number (current + 1)

      16. Concurrent edits can cause version conflicts; always fetch current version immediately before updating

      17. Title changes during update must still be unique within the space

        18. Quick Reference

        TaskTool SlugKey Params
        List spacesCONFLUENCE_GET_SPACEStype, status, limit
        Get space by IDCONFLUENCE_GET_SPACE_BY_IDid
        Create spaceCONFLUENCE_CREATE_SPACEkey, name, type
        Space contentsCONFLUENCE_GET_SPACE_CONTENTSspaceKey, type, status
        Space propertiesCONFLUENCE_GET_SPACE_PROPERTIESid, key
        Search contentCONFLUENCE_SEARCH_CONTENTquery, spaceKey, limit
        CQL searchCONFLUENCE_CQL_SEARCHcql, expand, limit
        List pagesCONFLUENCE_GET_PAGESspaceId, sort, limit
        Get page by IDCONFLUENCE_GET_PAGE_BY_IDid (integer)
        Create pageCONFLUENCE_CREATE_PAGEtitle, spaceId, body
        Update pageCONFLUENCE_UPDATE_PAGEid, title, body, version
        Delete pageCONFLUENCE_DELETE_PAGEid
        Child pagesCONFLUENCE_GET_CHILD_PAGESid, limit, sort
        Page ancestorsCONFLUENCE_GET_PAGE_ANCESTORSid
        Page labelsCONFLUENCE_GET_LABELS_FOR_PAGEid
        Add labelCONFLUENCE_ADD_CONTENT_LABELcontent ID, label
        Page versionsCONFLUENCE_GET_PAGE_VERSIONSid
        Space labelsCONFLUENCE_GET_LABELS_FOR_SPACEspace ID