KosmoKrator

productivity

Confluence MCP Integration for OpenAI Agents SDK

Connect Confluence to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

12 functions 7 read 5 write API token auth
Submit Confluence feedback View package source

Connect Confluence to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Confluence MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-confluence": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=confluence",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=confluence --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Confluence instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Confluence Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Confluence integration catalog.

MCP toolSource functionTypeDescription
integration__confluence__confluence_create_page confluence.confluence_create_page Write Create a new page in a Confluence space. Requires space_key, title, and body (HTML). Optionally specify a parent page ID.
integration__confluence__confluence_get_page confluence.confluence_get_page Read Get details for a specific Confluence page by ID. Returns title, body, version, space, and other metadata.
integration__confluence__confluence_update_page confluence.confluence_update_page Write Update an existing Confluence page. Requires page_id, title, body, and the new version number (current version + 1).
integration__confluence__confluence_delete_page confluence.confluence_delete_page Write Delete a Confluence page by its ID. This action moves the page to the trash.
integration__confluence__confluence_search_pages confluence.confluence_search_pages Read Search for Confluence content using CQL (Confluence Query Language). Examples: 'title = "My Page"', 'space = "DEV" and type = "page"'.
integration__confluence__confluence_get_page_ancestors confluence.confluence_get_page_ancestors Read Get the ancestor (parent) pages of a Confluence page by its ID. Returns the full ancestor hierarchy.
integration__confluence__confluence_get_page_children confluence.confluence_get_page_children Read Get the child pages of a Confluence page by its ID. Supports pagination and property expansion.
integration__confluence__confluence_add_comment confluence.confluence_add_comment Write Add a comment to a Confluence page. Requires the page ID and comment body in HTML.
integration__confluence__confluence_get_spaces confluence.confluence_get_spaces Read List Confluence spaces accessible to the authenticated user. Supports pagination and filtering by type and status.
integration__confluence__confluence_get_space confluence.confluence_get_space Read Get details for a specific Confluence space by its key.
integration__confluence__confluence_get_labels confluence.confluence_get_labels Read Get the labels attached to a Confluence page by its ID.
integration__confluence__confluence_add_labels confluence.confluence_add_labels Write Add one or more labels to a Confluence page. Labels are provided as an array of name strings.

Related Confluence Pages

Confluence CLIUse direct JSON commands instead of MCP discovery. Confluence MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.