confluence-connector

Run CQL searches and manage Confluence pages, comments, and attachments.

10|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/narailabs/narai-primitives --skill confluence-connector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: confluence-connector
Source: https://github.com/narailabs/narai-primitives/tree/main/plugins/confluence-connector/skills/confluence-connector
Command: npx skills add https://github.com/narailabs/narai-primitives --skill confluence-connector

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you safely retrieve Confluence content and perform page or comment write operations without manually navigating the Confluence UI or risking unauthorized changes.

Core Features & Use Cases

  • Confluence search and retrieval: Run CQL searches and fetch pages/spaces along with related metadata like attachments, comments, and versions.
  • Page and comment write operations: Create, update, delete pages and add comments, including attachment uploads via multipart.
  • Policy-gated safety by design: Every action passes the policy gate before any Atlassian REST v1 call is made, with write/delete escalating by default and admin/privilege hard-denied.

Quick Start

Create or update a Confluence page titled “Sprint Plan” in space “DEV” by calling the confluence-connector with action update_page and providing a valid ADF or markdown body.

Frequently Asked Questions about confluence-connector

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search Confluence pages using CQL and retrieve space metadata?

To search Confluence pages using CQL, you invoke the connector with validated JSON parameters to execute CQL searches and fetch pages, spaces, attachments, comments, and version metadata. The system enforces a policy gate before making any Atlassian REST v1 network call to retrieve your content.

Can I create and update Confluence pages with ADF or markdown content?

Yes, you can create and update Confluence pages by calling the update_page action with a valid ADF or markdown body. The connector handles page and comment write operations safely, applying a policy gate that escalates write and delete actions by default before execution.

Does the Confluence connector support multipart attachment uploads?

The Confluence connector supports multipart attachment uploads alongside page and comment write tasks. It applies policy-gated safety by design, ensuring every attachment upload passes validation before any Atlassian REST v1 call is made to your Confluence instance.

What are the policy gating restrictions for Confluence write operations?

Policy gating for Confluence write operations enforces safety by passing every action through a validation gate before any REST v1 call. Write and delete actions escalate by default, while admin and privilege actions are hard-denied to prevent unauthorized changes to pages and spaces.

How do I add comments to Confluence pages without navigating the UI?

You can add comments to Confluence pages by invoking the connector with the appropriate write action and validated JSON parameters. This bypasses manual UI navigation while maintaining safety through the enforced policy gate before the Atlassian REST v1 network call.