@aaronsb/confluence-cloud-mcp

Confluence Cloud MCP Server

A Model Context Protocol server for interacting with Confluence Cloud. Structured page editing with session-based change tracking, native macro support, and graph-based navigation.

Install

Claude Desktop (one-click)

Download confluence-cloud-mcp.mcpb and open it — Claude Desktop will prompt for your Confluence credentials.

Claude Code

claude mcp add confluence-cloud -e CONFLUENCE_API_TOKEN=your-token -e CONFLUENCE_EMAIL=your-email -e CONFLUENCE_HOST=https://your-team.atlassian.net -- npx -y @aaronsb/confluence-cloud-mcp

Manual (any MCP client)

{
  "mcpServers": {
    "confluence-cloud": {
      "command": "npx",
      "args": ["-y", "@aaronsb/confluence-cloud-mcp"],
      "env": {
        "CONFLUENCE_API_TOKEN": "your-api-token",
        "CONFLUENCE_EMAIL": "your-email",
        "CONFLUENCE_HOST": "https://your-team.atlassian.net"
      }
    }
  }
}

Credentials

Generate an API token at Atlassian Account Settings.

Tools

Tool	Description
manage_confluence_page	Get, create, update, delete, move, copy, or pull pages for editing
edit_confluence_content	Structural block editing within a tracked session — patch sections, append, replace, find/replace, sync
manage_confluence_space	List spaces, get space details, or manage space configuration
search_confluence	Search using CQL, full-text, labels, or contributors
manage_confluence_media	Upload, download, list, or delete page attachments
navigate_confluence	Traverse page hierarchy, discover backlinks (via GraphQL), forward links, and related pages
queue_confluence_operations	Batch multiple operations with result references ($0.pageId) and error strategies

Each tool accepts an operation parameter (except queue_confluence_operations which takes an operations array). Per-tool documentation is available as MCP resources at confluence://tools/{tool_name}/documentation.

Key Features

Session-based editing — Pull a page into a tracked session, make surgical edits to individual blocks (sections, paragraphs, macros, tables), then sync only what changed. No full-page rewrites.

Native macro support — Status badges, info/warning/error panels, expand blocks, and table of contents render as readable :::directive syntax. The server handles ADF serialization with correct native node types.

GraphQL navigation — Backlinks and forward links use the Atlassian GraphQL gateway's link graph for accurate, fast relationship discovery. Falls back to REST when GraphQL is unavailable.

Rendering facades — Every response is token-efficient markdown with context-aware next-step hints. No raw JSON.

MCP Resources

Resource	Description
confluence://macros	Available macro registry with parameter schemas and usage examples

Architecture

See docs/architecture/INDEX.md for the 8 ADRs covering the five-layer architecture, hybrid client, content model, session editing, macro handling, navigation, and rendering facades.

License

MIT License