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
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
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.