conf_ls_pages

conf_ls_pages

Find and list pages in Confluence spaces using smart title matching, filtering by status, and pagination. Supports sorting by properties like title, creation, or modification date. Returns page details including ID, title, status, and URL.

Instructions

Lists pages within specified spaces (by spaceId or spaceKey) or globally. Filters by title with SMART MATCHING: tries exact match first, automatically falls back to partial matching if no exact results found. Supports status (current, archived, etc.), sorting (sort) and pagination (limit, cursor).

Returns a formatted list of pages including ID, title, status, space ID, author, version, and URL.
Pagination information including next cursor value is included at the end of the returned text content.
SMART TITLE SEARCH: When using title parameter, if exact match fails, automatically searches for partial matches (e.g., "Balance" will find "Balance Reconciliation System").
For full-text content search or advanced queries, use the conf_search tool.
Requires Confluence credentials.

Input Schema

Name	Required	Description
`cursor`	No	Pagination cursor for retrieving the next set of results. Obtain this opaque string from the metadata.pagination.nextCursor of a previous response when more results are available. Confluence uses cursor-based pagination rather than offset-based pagination.
`limit`	No	Maximum number of items to return (1-250). Controls the response size. Defaults to 25 if omitted. The Confluence API caps results at 250 items per request.
`parentId`	No	Optional: Parent page ID to filter for child pages only.
`sort`	No	Optional: Property to sort pages by. Default is "-modified-date" (most recently modified first). The "-" prefix indicates descending order. Valid values: "id", "-id", "created-date", "-created-date", "modified-date", "-modified-date", "title", "-title".
`spaceIds`	No	Optional: Numeric Space IDs to filter by. Either use this OR spaceKeys, not both together. If both are provided, only spaceIds will be used.
`spaceKeys`	No	Optional: Space Keys (e.g., "DEV") to filter by. Either use this OR spaceIds, not both together. If both are provided, only spaceIds will be used. Preferred for usability as keys are more human-readable than IDs.
`status`	No	Optional: Filter pages by status. Options: "current" (published), "trashed", "deleted", "archived", "historical" (previous versions). Defaults to ["current"] if not specified. Provide as an array to include multiple statuses.
`title`	No	Filter pages by title with SMART MATCHING. First tries exact match, then automatically falls back to partial matching if no exact results found. For example, "Balance" will find "Balance Reconciliation System - Documentation Summary". For full-text content search or advanced CQL queries, use the `conf_search` tool instead.

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "cursor": {
      "description": "Pagination cursor for retrieving the next set of results. Obtain this opaque string from the metadata.pagination.nextCursor of a previous response when more results are available. Confluence uses cursor-based pagination rather than offset-based pagination.",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of items to return (1-250). Controls the response size. Defaults to 25 if omitted. The Confluence API caps results at 250 items per request.",
      "exclusiveMinimum": 0,
      "maximum": 250,
      "minimum": 1,
      "type": "integer"
    },
    "parentId": {
      "description": "Optional: Parent page ID to filter for child pages only.",
      "type": "string"
    },
    "sort": {
      "description": "Optional: Property to sort pages by. Default is \"-modified-date\" (most recently modified first). The \"-\" prefix indicates descending order. Valid values: \"id\", \"-id\", \"created-date\", \"-created-date\", \"modified-date\", \"-modified-date\", \"title\", \"-title\".",
      "enum": [
        "id",
        "-id",
        "created-date",
        "-created-date",
        "modified-date",
        "-modified-date",
        "title",
        "-title"
      ],
      "type": "string"
    },
    "spaceIds": {
      "description": "Optional: Numeric Space IDs to filter by. Either use this OR spaceKeys, not both together. If both are provided, only spaceIds will be used.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "spaceKeys": {
      "description": "Optional: Space Keys (e.g., \"DEV\") to filter by. Either use this OR spaceIds, not both together. If both are provided, only spaceIds will be used. Preferred for usability as keys are more human-readable than IDs.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "status": {
      "description": "Optional: Filter pages by status. Options: \"current\" (published), \"trashed\", \"deleted\", \"archived\", \"historical\" (previous versions). Defaults to [\"current\"] if not specified. Provide as an array to include multiple statuses.",
      "items": {
        "enum": [
          "current",
          "trashed",
          "deleted",
          "archived",
          "historical"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "title": {
      "description": "Filter pages by title with SMART MATCHING. First tries exact match, then automatically falls back to partial matching if no exact results found. For example, \"Balance\" will find \"Balance Reconciliation System - Documentation Summary\". For full-text content search or advanced CQL queries, use the `conf_search` tool instead.",
      "type": "string"
    }
  },
  "type": "object"
}

Atlassian Confluence MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Atlassian Confluence MCP Server

Related Tools

MCP directory API