search

Search for content across Confluence using Confluence Query Language (CQL).

PURPOSE: Finds content matching specific criteria with excerpts showing matches, helping you discover relevant information across spaces.

WHEN TO USE:

When you need to find specific content across multiple spaces
When you want to search by various criteria (text, title, labels, content type)
When you need to gather information scattered across different pages
When you're unfamiliar with the structure of Confluence and need discovery
When looking for content with specific labels or within specific date ranges

WHEN NOT TO USE:

When you already know the exact space and page (use get-page instead)
When you want to list all spaces or pages systematically (use list-spaces/list-pages)
When performing many rapid, consecutive searches (consider rate limits)
When you need to retrieve complete page content (use get-page after search)

RETURNS: Search results with titles, excerpts showing matches, content types, spaces, and URLs, plus pagination info.

EXAMPLES:

Simple text search: {cql: "text~documentation"}
Space-specific search: {cql: "space=DEV AND text~API"}
Title search: {cql: "title~Project Plan"}
Content type filter: {cql: "type=page AND label=important"}
With pagination: {cql: "text~API", limit: 10, cursor: "next-page-token"}

ERRORS:

Invalid CQL syntax: Check CQL syntax (example: "type=page AND space=DEV")
No results: Try broader search terms or check different spaces
Authentication failures: Check your Confluence credentials
Rate limiting: Use more specific queries and pagination

Input Schema

Name	Required	Description
`cql`	Yes	The Confluence Query Language (CQL) query to search for. This is a powerful query language that allows you to search for content based on various criteria. Examples: - Search by space: "space=DEV AND type=page" - Search by title: "title~Project AND type=page" - Search by content: "text~API AND type=page" - Search by label: "label=documentation AND type=page" - Combined search: "space=DEV AND title~Project AND created>=2023-01-01"
`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 results to return (1-100). Use this to control the response size. Useful for pagination or when you only need a few results. The Confluence API may have its own limits on the number of results returned.

Input Schema (JSON Schema)

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "cql": {
      "description": "The Confluence Query Language (CQL) query to search for. This is a powerful query language that allows you to search for content based on various criteria. Examples:\n- Search by space: \"space=DEV AND type=page\"\n- Search by title: \"title~Project AND type=page\"\n- Search by content: \"text~API AND type=page\"\n- Search by label: \"label=documentation AND type=page\"\n- Combined search: \"space=DEV AND title~Project AND created>=2023-01-01\"",
      "type": "string"
    },
    "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 results to return (1-100). Use this to control the response size. Useful for pagination or when you only need a few results. The Confluence API may have its own limits on the number of results returned.",
      "maximum": 100,
      "minimum": 1,
      "type": "number"
    }
  },
  "required": [
    "cql"
  ],
  "type": "object"
}

search

Input Schema

Input Schema (JSON Schema)

Other Tools