Aby Atlassian
Search Confluence with CQL
Returns the Confluence pages, blog posts and other content that match a CQL query.
Description
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`.
search-confluence.md
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.
{ "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.
Built from these files in the repository
The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.