Summary
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.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →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
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
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)
Categories
Registryactive
Package@aaronsb/confluence-cloud-mcp
TransportSTDIO
AuthRequired
UpdatedMar 27, 2026
