list-pages

Discover and filter Confluence pages by space, status, or pagination to retrieve IDs, titles, and locations. Use this tool to browse available content or gather page details for integration with other Confluence tools.

Instructions

List Confluence pages with optional filtering by space and status.

PURPOSE: Finds pages within Confluence spaces with their IDs, titles, and locations to help you discover available content.

WHEN TO USE:

When you need to find pages within a specific space
When you want to list the most recently updated content
When you need to browse available pages before accessing specific content
When you need page IDs for use with other Confluence tools
When looking for pages with specific statuses (current, draft, trashed)

WHEN NOT TO USE:

When you already know the specific page ID (use get-page instead)
When you need the actual content of a page (use get-page instead)
When you need to search across multiple spaces (use search instead)
When you need to find spaces rather than pages (use list-spaces instead)

RETURNS: Formatted list of pages with IDs, titles, space information, and URLs, plus pagination info.

EXAMPLES:

Pages in a space: {spaceId: "DEV"}
With status filter: {spaceId: "DEV", status: "current"}
With pagination: {spaceId: "DEV", limit: 10, cursor: "next-page-token"}

ERRORS:

Space not found: Verify the space ID is correct
Authentication failures: Check your Confluence credentials
No pages found: The space might be empty or you lack permissions
Rate limiting: Use pagination and reduce query frequency

Input Schema

Name	Required	Description
`cursor`	No	Pagination cursor for retrieving the next set of results. Use this to navigate through large result sets. The cursor value can be obtained from the pagination information in a previous response.
`limit`	No	Maximum number of pages to return (1-250). Use this to control the response size. Useful for pagination or when you only need a few results. The Confluence API caps results at 250 items per request.
`spaceId`	No	Filter pages by space IDs. Provide an array of space IDs (e.g., ["123456", "789012"]) to only show pages from specific spaces. Useful when you want to focus on content from particular projects or teams.
`status`	No	Filter pages by status. Options include: "current" (published pages), "trashed" (pages in trash), "deleted" (permanently deleted), "draft" (unpublished drafts), "archived" (archived pages), or "historical" (previous versions). Defaults to "current" if not specified. Provide as an array to include multiple statuses.

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. Use this to navigate through large result sets. The cursor value can be obtained from the pagination information in a previous response.",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of pages to return (1-250). Use this to control the response size. Useful for pagination or when you only need a few results. The Confluence API caps results at 250 items per request.",
      "maximum": 250,
      "minimum": 1,
      "type": "number"
    },
    "spaceId": {
      "description": "Filter pages by space IDs. Provide an array of space IDs (e.g., [\"123456\", \"789012\"]) to only show pages from specific spaces. Useful when you want to focus on content from particular projects or teams.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "status": {
      "description": "Filter pages by status. Options include: \"current\" (published pages), \"trashed\" (pages in trash), \"deleted\" (permanently deleted), \"draft\" (unpublished drafts), \"archived\" (archived pages), or \"historical\" (previous versions). Defaults to \"current\" if not specified. Provide as an array to include multiple statuses.",
      "items": {
        "enum": [
          "current",
          "trashed",
          "deleted",
          "draft",
          "archived",
          "historical"
        ],
        "type": "string"
      },
      "type": "array"
    }
  },
  "type": "object"
}

Atlassian Confluence MCP Server

list-pages

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Atlassian Confluence MCP Server

Related Tools