Confluence Data Center MCP Server

AI meets Confluence Data Center - Connect AI assistants to your Confluence Data Center instance with production-ready tools and comprehensive page management capabilities

🚀 What is this?

Confluence Data Center MCP Server enables AI assistants like Claude, Cline, Cursor, and other MCP-compatible tools to interact seamlessly with Atlassian Confluence Data Center using Personal Access Token authentication. Create, read, update, delete pages, manage comments, and search content - all through natural language conversations with your AI assistant.

✨ Features

🛠️ 11 Production-Ready Tools:

Page Management (5 tools):

• ✅ createPage - Create new pages with rich content and hierarchical organization
• ✅ getPageContent - Retrieve page content and metadata with comprehensive expansion
• ✅ updatePage - Update titles and content with version control and conflict resolution
• ✅ deletePage - Remove pages safely with recoverable soft delete options
• ✅ getSpaces - List and explore available spaces with permissions

Search & Discovery (2 tools):

• ✅ searchPages - Universal search with CQL support and advanced filtering
• ✅ getPageVersions - Access complete page version history for change tracking

Comment Management (4 tools):

• ✅ getPageComments - Retrieve page comments and replies with threading support
• ✅ addComment - Add comments with reply threading and content validation
• ✅ updateComment - Edit existing comments with version control
• ✅ deleteComment - Remove comments with cascading reply deletion

🎯 Key Capabilities:

• ✅ Production Ready - 100% success rate across all 11 tools
• ✅ Data Center Focused - Optimized for Confluence Data Center deployments
• ✅ AI Client Validated - Tested with Claude Desktop, Cline, and Cursor
• ✅ Comprehensive Coverage - Full page lifecycle and collaboration features
• ✅ Version Control - Safe concurrent editing with conflict resolution
• ✅ Search Integration - CQL-powered search with fallback strategies
• ✅ Personal Access Token - Secure Bearer token authentication

🚀 Quick Start

📦 Install from NPM (Recommended)

npm install -g confluence-dc-mcp-server

⚙️ Quick Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "confluence-dc": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "node",
      "args": ["/opt/homebrew/bin/confluence-dc-mcp-server"],
      "env": {
        "CONFLUENCE_BASE_URL": "https://your-confluence-dc.company.com",
        "CONFLUENCE_PERSONAL_ACCESS_TOKEN": "your-personal-access-token"
      }
    }
  }
}

💡 Find your installation path: Use which confluence-dc-mcp-server to locate the binary

📦 Alternative: Install from Source

For development or customization:

git clone https://github.com/phuc-nt/confluence-dc-mcp-server.git
cd confluence-dc-mcp-server
npm install
npm run build
# Use: /path/to/confluence-dc-mcp-server/dist/index.js

💡 Why node+args format? This format provides universal compatibility across all MCP clients and platforms, avoiding potential executable detection issues.

💡 Configuration Guide: Follow the complete setup guide in INSTALL.md

📊 Project Status

Overall Progress: ✅ All Sprints COMPLETED - Full collaboration platform ready
Tools Operational: 11/11 tools fully functional (100% complete)
AI Client Status: ✅ Production Ready - Validated with multiple clients
Success Rate: 100% functional, 100% MCP protocol compliant

Current Tool Distribution

| Category | Tools | Status | Success Rate | |----------|-------|--------|--------------| | Page Management | 5 | ✅ Complete | 100% | | Search & Discovery | 2 | ✅ Complete | 100% | | Comment Management | 4 | ✅ Complete | 100% |

💡 Usage Examples

Create Pages with Natural Language:

Human: Create a new page called "API Documentation" in the dev space with a simple structure

AI Assistant: I'll create that page for you using the createPage tool:
□ Space: dev
□ Title: "API Documentation" 
□ Creating page with basic structure...

✅ Created page DEV-123: "API Documentation"
🔗 View at: https://your-confluence-dc.company.com/pages/123456

Version History & Content Comparison:

Human: Show me the version history of page 123456 and compare current content with version 3

AI Assistant: I'll get the version history and compare content for you:
□ Using getPageVersions to get complete history...
□ Found 8 versions from 2024-01-15 to 2024-08-27
□ Using getPageContent for current version and version 3...
□ Comparing content differences...

✅ Version comparison complete:
📊 Version 8 (current): 1,245 characters, last edited by John Doe
📊 Version 3: 892 characters, edited 6 months ago by Jane Smith  
🔍 Key changes: Added security section, updated API examples

Smart Content Search:

Human: Find all pages about user authentication from the last month

AI Assistant: I'll search for authentication-related content using searchPages:
□ Using CQL: "text~authentication AND created >= -30d"
□ Searching across all accessible spaces...

Found 8 relevant pages:
• AUTH-101: "User Authentication Flow" (updated 3 days ago)
• SEC-045: "OAuth Implementation Guide" (created last week)
• [Additional results with context and links...]

Comment Collaboration:

Human: Add a comment to page DEV-123 asking the team to review the security section

AI Assistant: I'll add your review request comment:
□ Target: DEV-123 "API Documentation"
□ Adding comment with review request...

✅ Comment added successfully!
💬 "Hi team, please review the security section for completeness and accuracy"
🔗 View page with new comment

Version Management:

Human: Check the version history of page DEV-123 and update it to version 5

AI Assistant: I'll check the version history first:
□ Using getPageVersions for DEV-123...
□ Current version: 4 (last updated 2 hours ago)
□ Ready to update to version 5...

Version History:
• v4: Updated by John Doe (2 hours ago) - "Added security examples"
• v3: Updated by Jane Smith (1 day ago) - "Initial API docs"

Ready to update - what changes would you like to make?

🛠️ Architecture

API Integration

• Confluence REST API v1 - Universal API for all operations with Data Center compatibility
• Single Client Architecture - Optimized for Data Center deployments
• CQL Search Support - Advanced query capabilities
• Bearer Authentication - Personal Access Token secure access
• SSL Certificate Support - Handles self-signed certificates for enterprise deployments

MCP Protocol Compliance

• Tool-Only Architecture - Focused on action capabilities
• Structured Responses - Consistent JSON output format
• Error Handling - Comprehensive error reporting and recovery
• Parameter Validation - Input safety and validation
• Version Management - Optimistic locking for concurrent access

🛠️ Tech Stack

• TypeScript - Type-safe development with strict mode
• Node.js - Runtime environment (16.x+)
• MCP Protocol - Model Context Protocol for AI integration
• Confluence APIs - Native Confluence Data Center REST API v1
• Axios - HTTP client with interceptors and SSL handling

💼 Production Use Cases

• Documentation Management - Automated page creation and updates
• Content Migration - Batch operations and content transfer
• Team Collaboration - Comment management and review workflows
• Search & Discovery - Intelligent content finding and organization
• Version Control - Safe concurrent editing and change tracking
• Enterprise Integration - Data Center deployment support with SSL handling

🤖 AI Client Compatibility

Tested and validated with:

• ✅ Claude Desktop - Full feature compatibility
• ✅ Cline - Complete workflow integration
• ✅ Cursor - Native MCP protocol support
• ✅ Other MCP Clients - Standard MCP protocol compliance

🏢 Data Center Features

• Self-Hosted Support - Works with on-premise Confluence Data Center installations
• SSL Certificate Handling - Support for self-signed certificates
• Custom Base URLs - Flexible configuration for various deployment scenarios
• Personal Access Token - Secure authentication method for Data Center
• Enterprise Security - Designed for enterprise security requirements

📄 License

MIT License - see LICENSE for details.

🎉 Connect your AI assistant to Confluence Data Center with production-ready tools and comprehensive collaboration features!