About Confluence Cloud
Confluence Cloud MCP server for managing pages, spaces, attachments, and navigation. Its tracked editing sessions support block-level changes and native macros without rewriting whole pages.
Key features
- 01Manage pages and spaces
- 02Edit tracked content blocks
- 03Handle native macros
- 04Search and manage attachments
- 05Navigate links and page hierarchy
- 06Batch operations with references
Use cases
- 01Update selected sections without replacing a full page
- 02Find pages by text, labels, or contributors
- 03Trace backlinks and related pages
- 04Run dependent Confluence operations in batches
MCP support
Exposes Confluence page, content, space, media, search, navigation, and batch-operation tools to MCP clients. Tool documentation and a macro registry are also available as MCP resources.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y @aaronsb/confluence-cloud-mcpCONFLUENCE_API_TOKENSecretConfluence API token (generate at https://id.atlassian.com/manage/api-tokens)CONFLUENCE_EMAILAtlassian account email addressCONFLUENCE_HOSTConfluence instance URL (e.g., https://your-team.atlassian.net)Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
8Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| body | string | No | Comment text as markdown (for add_comment). Rendered through the same directive parser as page content. |
| label | string | No | Label to remove (for remove_label operation) |
| title | string | No | Page title (required for create, optional for update) |
| expand | array | No | Additional data to include in the response |
| labels | array | No | Labels to add (for add_labels operation) |
| pageId | string | No | Page ID (required for get, update, delete, move, copy, get_versions, pull_for_editing, get_comments, add_comment, archive, archive_tree, unarchive) |
| spaceId | string | No | Space ID (required for create, usable for list_archived) |
| parentId | string | No | Parent page ID (optional for create, required for move, optional for copy) |
| spaceKey | string | No | Space key (for list_archived) |
| operation | enum | Yes | The operation to performget | create | update | delete | move | copy | get_versions | pull_for_editing | get_comments | add_comment | get_labels | add_labels | remove_label | get_properties | get_property | set_property | delete_property | archive | archive_tree | unarchive | list_archived |
| propertyKey | string | No | Content property key (for get_property, set_property, delete_property) |
| propertyValue | object | No | Content property value as JSON object (for set_property) |
| parentCommentId | string | No | Comment ID to reply to (optional for add_comment). Ids come from get_comments; replies to inline comments land on that inline thread. |
Details
From the project READMEConfluence 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.