---
ref: tool:atlassian/search-confluence
name: Search Confluence with CQL
company: company:atlassian
workflows: []
access: [mcp, api]
tags: [capability:manage-docs, category:project-management, has:api, has:mcp]
docs: https://developer.atlassian.com/cloud/confluence/rest/v1/api-group-search/#api-wiki-rest-api-search-get
updated: 2026-09-27
---

# Search Confluence with CQL

Returns the Confluence pages, blog posts and other content that match a CQL query.

Pass the query as `cql`, such as `type=page`, and a `limit`. When more results
exist, the response's `next` link carries a cursor for the following page. CQL
here no longer supports user fields such as `user` or `user.accountid`.

## Set up

Use the first option your agent supports.

### MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

```json
{ "mcpServers": { "atlassian": { "url": "https://mcp.atlassian.com/v2/mcp" } } }
```

Call the MCP tool `searchConfluence`.

Server URL: https://mcp.atlassian.com/v2/mcp

### API (official)

- Base URL: https://{your-domain}.atlassian.net
- Endpoint: `GET /wiki/rest/api/search`
- Auth: send the header `Authorization: Basic $ATLASSIAN_API_KEY`
- Get a key: https://id.atlassian.com/manage-profile/security/api-tokens
- Docs: https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/

Before doing anything else, make one read-only call to confirm access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data.
- Never print API keys.