Confluence
Connects to the Confluence Cloud REST API for searching and managing wiki pages and spaces. An agent can search content, read and edit pages, and browse the page hierarchy.
Add to an agent node's tools array with _node_type: "tool-confluence". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
base_url | Yes | Confluence site base URL (e.g. https://myorg.atlassian.net/wiki). Trailing slash is stripped. |
email | Yes | Atlassian account email, used for HTTP Basic auth. |
api_token | Yes | Atlassian API token, used for HTTP Basic auth. |
{
"name": "confluence",
"_node_type": "tool-confluence",
"base_url": "https://myorg.atlassian.net/wiki",
"email": "{{ secret.CONFLUENCE_EMAIL }}",
"api_token": "{{ secret.CONFLUENCE_API_TOKEN }}"
}
Tools
confluence_search
Search Confluence using CQL (Confluence Query Language). Examples: text~kubernetes, space=ENG AND type=page.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | CQL search query (e.g. type=page AND space=ENG AND title~Design) |
limit | number | No | Max results (default 10) |
Returns: A newline-separated list of - **<title>** [<space name>] id: <id> lines, or "No results found.".
confluence_get_page
Get a Confluence page's title and content.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id | string | Yes | Confluence page ID |
Returns: A formatted string with the page title, space name, version number, and the page body (storage format/HTML).
confluence_create_page
Create a new Confluence page in a space.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
space_key | string | Yes | Space key (e.g. ENG, DEV) |
title | string | Yes | Page title |
content | string | Yes | Page content as plain text or HTML (Confluence storage format) |
parent_id | string | No | Parent page ID (optional) |
Returns: A confirmation message with the page title, new page ID, and full URL.
confluence_update_page
Update an existing Confluence page. Use confluence_get_page first to get the current version number.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id | string | Yes | Page ID to update |
title | string | Yes | New page title |
content | string | Yes | New page content |
version | number | Yes | Current version number (required for optimistic locking — the tool increments it by 1) |
Returns: A confirmation message with the updated page's title and ID.
confluence_list_spaces
List all Confluence spaces.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | number | No | Max spaces to return (default 20) |
Returns: A newline-separated list of - **<name>** (key: <key>) lines for global spaces, or "No spaces found.".
confluence_get_page_children
List child pages of a Confluence page.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
page_id | string | Yes | Parent page ID |
Returns: A newline-separated list of - **<title>** id: <id> lines, or "No child pages.".