English Français العربية

Confluence Cloud

Official registry Other

MCP server for Confluence Cloud — page editing, navigation, and content management

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @aaronsb/confluence-cloud-mcp
Claude Code 
claude mcp add confluence-cloud -e 'CONFLUENCE_API_TOKEN=<your confluence_api_token>' -e 'CONFLUENCE_EMAIL=<CONFLUENCE_EMAIL>' -e 'CONFLUENCE_HOST=<CONFLUENCE_HOST>' -- npx -y @aaronsb/confluence-cloud-mcp@0.6.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "confluence-cloud": {
            "command": "npx",
            "args": [
                "-y",
                "@aaronsb/confluence-cloud-mcp@0.6.0"
            ],
            "env": {
                "CONFLUENCE_API_TOKEN": "<your confluence_api_token>",
                "CONFLUENCE_EMAIL": "<CONFLUENCE_EMAIL>",
                "CONFLUENCE_HOST": "<CONFLUENCE_HOST>"
            }
        }
    }
}

Environment variables

  • CONFLUENCE_API_TOKEN required secret Confluence API token (generate at https://id.atlassian.com/manage/api-tokens)
  • CONFLUENCE_EMAIL required Atlassian account email address
  • CONFLUENCE_HOST required Confluence instance URL (e.g., https://your-team.atlassian.net)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Confluence Cloud MCP Server
  2. Install
  3. Tools
  4. Key Features
  5. MCP Resources
  6. Architecture
  7. License

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

ToolDescription
manage_confluence_pageGet, create, update, delete, move, copy, or pull pages for editing
edit_confluence_contentStructural block editing within a tracked session — patch sections, append, replace, find/replace, sync
manage_confluence_spaceList spaces, get space details, or manage space configuration
search_confluenceSearch using CQL, full-text, labels, or contributors
manage_confluence_mediaUpload, download, list, or delete page attachments
navigate_confluenceTraverse page hierarchy, discover backlinks (via GraphQL), forward links, and related pages
queue_confluence_operationsBatch 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

ResourceDescription
confluence://macrosAvailable 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

Frequently asked questions

What is Confluence Cloud?

MCP server for Confluence Cloud — page editing, navigation, and content management

How do I install Confluence Cloud?

It runs on your machine. In Claude Code: claude mcp add confluence-cloud -e 'CONFLUENCE_API_TOKEN=<your confluence_api_token>' -e 'CONFLUENCE_EMAIL=<CONFLUENCE_EMAIL>' -e 'CONFLUENCE_HOST=<CONFLUENCE_HOST>' -- npx -y @aaronsb/confluence-cloud-mcp@0.6.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Confluence Cloud need an API key?

Yes. It expects CONFLUENCE_API_TOKEN, CONFLUENCE_EMAIL, CONFLUENCE_HOST, which you set in its configuration.

Is Confluence Cloud open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Confluence Cloud?

It is published by aaronsb. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.