Confluence MCP Server

Confluence MCP Server v2.0 - Selective Editing

Confluence MCP Server v2.0 introduces selective editing capabilities for AI assistants.

A MCP (Model Context Protocol) server that enables AI assistants to interact with Confluence. Beyond basic page management, v2.0 introduces targeted editing that allows AI to make specific modifications while preserving existing content, formatting, and macros.

✨ What's New in v2.0

🎯 Targeted Editing Capabilities

v2.0 enables selective modifications instead of full page replacement:

• Section Updates: Modify specific sections under headings without touching other content
• Pattern Replacement: Find and replace text while preserving XML structure and macros
• Table Cell Editing: Update individual table cells without affecting table structure
• Structure Preservation: Maintains all formatting, layouts, macros, and custom elements

🧠 XML-Aware Operations

• Confluence Storage Format Support: Understands and preserves Confluence's XML structure
• Macro Safety: Avoids breaking macros, layouts, or custom elements during edits
• Content Analysis: Identifies safe editing locations and content boundaries
• Rollback Capability: Automatic backup creation for safe editing operations

🛠️ 14 Tools Available

Standard Tools (10): Complete page, space, attachment, and comment management 🆕 Selective Editing Tools (4): Targeted editing capabilities

🚀 Selective Editing Tools

1. update_page_section - Section Replacement

Updates specific sections under headings without affecting surrounding content.

Example: Update project status without touching meeting notes

Features:

• Heading detection (H1-H6) with hierarchy support
• Flexible matching: case-sensitive, exact match, or fuzzy search
• Nested heading support for complex document structures
• Preserves all macros, layouts, and formatting outside target section

2. replace_text_pattern - Find & Replace with Structure Preservation

Replaces text patterns throughout pages while preserving document structure.

Example: Update product version across documentation

Features:

• Content detection distinguishes text from XML markup
• Case sensitivity and whole-word matching options
• Replacement limits for controlled changes
• Preserves macros, links, and formatting elements

3. update_table_cell - Table Cell Editing

Updates specific table cells while maintaining table structure and formatting.

Example: Update project metrics in status tables

Features:

• Zero-based indexing for precise cell targeting
• Rich HTML content support within cells
• Table structure preservation (borders, styling, headers)
• Targeted modification - only specified cell is changed

4. add_section_at_end - Section Addition

Adds new content sections at the end of pages while preserving existing structure.

Example: Append new meeting notes without affecting existing content

Features:

• Automatic heading level detection and assignment
• Document structure preservation during insertion
• Safe positioning at document end without content disruption
• Maintains all macros, layouts, and formatting in existing content

🌐 Universal Deployment Platform

🚀 Deployment Options

🛠️ Complete Tool Suite

📄 Standard Confluence Tools (10)

🎯 Selective Editing Tools (4)

🚀 Quick Start

📚 New to Selective Editing?

👉 Complete Step-by-Step Tutorial - Learn selective editing with hands-on examples!

Option 1: Claude Desktop (stdio transport)

1. Install Dependencies:
   pip install -r requirements.txt
2. Configure Claude Desktop:
   { "mcpServers": { "confluence": { "command": "python", "args": ["-m", "confluence_mcp_server.main"], "env": { "CONFLUENCE_URL": "https://your-org.atlassian.net", "CONFLUENCE_USERNAME": "your-email@domain.com", "CONFLUENCE_API_TOKEN": "your-api-token" } } } }
3. Restart Claude Desktop and look for the 🔨 hammer icon showing 14 tools

Option 2: HTTP Server

1. Install Dependencies:
   pip install -r requirements.txt
2. Set Environment Variables:
   export CONFLUENCE_URL="https://your-org.atlassian.net" export CONFLUENCE_USERNAME="your-email@domain.com" export CONFLUENCE_API_TOKEN="your-api-token"
3. Start HTTP Server:
   python -m confluence_mcp_server.server_http_optimized
4. Test the Server:
   curl http://localhost:8000/mcp # Returns: 14 tools including selective editing capabilities

Option 3: Docker Deployment

1. Build Container:
   docker build -f Dockerfile.smithery -t confluence-mcp-server-v2 .
2. Run Container:
   docker run -p 8000:8000 \ -e CONFLUENCE_URL="https://your-org.atlassian.net" \ -e CONFLUENCE_USERNAME="your-email@domain.com" \ -e CONFLUENCE_API_TOKEN="your-api-token" \ confluence-mcp-server-v2

Option 4: Smithery.ai Deployment

1. Upload Files: Upload smithery.yaml and server code to Smithery.ai
2. Configure Credentials: Set Confluence URL, username, and API token
3. Deploy: Smithery.ai automatically provides all 14 tools including selective editing

💬 AI Assistant Workflows

🎯 Selective Editing Examples

📚 Need Step-by-Step Guidance? 👉 Complete Selective Editing Tutorial - Hands-on guide with examples, workflows, and troubleshooting

Update Project Status Without Disrupting Meeting Notes:

Fix Typos Across Documentation:

Update Metrics in Status Dashboard: ```