Connects to Confluence Cloud's REST and GraphQL APIs to manage pages, spaces, and attachments. Exposes session-based editing that lets you pull a page, patch individual blocks (sections, paragraphs, tables), and sync only what changed instead of rewriting the whole thing. Handles native Confluence macros like status badges and info panels as readable directive syntax, and uses Atlassian's GraphQL gateway to traverse backlinks and page relationships. Includes CQL search, bulk operations with result references, and token-efficient markdown responses. Reach for this when you need surgical edits to wiki pages or want to navigate Confluence hierarchies without clicking through the web UI.
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.
Download confluence-cloud-mcp.mcpb and open it — Claude Desktop will prompt for your Confluence credentials.
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
{
"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"
}
}
}
}
Generate an API token at Atlassian Account Settings.
| 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.
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.
| Resource | Description |
|---|---|
confluence://macros | Available macro registry with parameter schemas and usage examples |
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.
CONFLUENCE_API_TOKEN*secretConfluence API token (generate at https://id.atlassian.com/manage/api-tokens)
CONFLUENCE_EMAIL*Atlassian account email address
CONFLUENCE_HOST*Confluence instance URL (e.g., https://your-team.atlassian.net)
csoai-org/pdf-document-mcp
xt765/mcp-document-converter
io.github.xjtlumedia/markdown-formatter
io.github.ai-aviate/better-notion
suekou/mcp-notion-server
meterlong/mcp-doc