MCP server for Confluence Cloud — page editing, navigation, and content management
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.
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y @aaronsb/confluence-cloud-mcpMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-aaronsb-confluence-cloud": {
"command": "npx",
"args": [
"-y",
"@aaronsb/confluence-cloud-mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referenceConfluence Cloud works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.