Skip to content
ctk

MCP Overview

ctk implements the Model Context Protocol over stdio. When you run ctk mcp, it starts a server that AI agents can call to interact with Confluence Cloud.

Starting the Server

Section titled “Starting the Server”
Terminal window
ctk mcp

The server reads credentials from environment variables or stored credentials (same as the CLI).

Write Gating

Section titled “Write Gating”

Write operations are disabled by default. When writes are disabled, tools like manage_pages only expose read actions (get, list, get_children, etc.). Create, update, delete, and move actions return an error.

To enable writes:

Terminal window
CTK_ENABLE_WRITES=true ctk mcp

The tool descriptions dynamically reflect which actions are available based on the CTK_ENABLE_WRITES setting.

Disabling Tools

Section titled “Disabling Tools”

You can disable specific tools with the CTK_DISABLED_TOOLS environment variable:

Terminal window
CTK_DISABLED_TOOLS="manage_comments,manage_attachments" ctk mcp

Available Tools

Section titled “Available Tools”

ctk registers 8 multiplexed tools. Each tool accepts an action parameter that determines the operation.

manage_spaces List and get Confluence spaces
manage_pages Full page lifecycle: get, list, create, update, delete, move, diff
manage_search CQL and quick text search
manage_labels List, add, and remove page labels
manage_folders List, get, create, and manage folders
manage_comments Footer comments, inline comments, and replies
manage_attachments List, download, upload, and delete page attachments
manage_users Get current user and search users