Atlassian Confluence MCP Server
by aashari
Verified
list-pages
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 | Default |
|---|---|---|---|
| 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. |