phuc-nt/confluence-cloud-mcp-server

Confluence Cloud MCP Server

AI meets Confluence - Connect AI assistants to your Confluence Cloud workspace with production-ready tools and comprehensive page management capabilities

🚀 What is this?

Confluence Cloud MCP Server enables AI assistants like Claude, Cline, Cursor, and other MCP-compatible tools to interact seamlessly with Atlassian Confluence Cloud using API 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
• ✅ getPageContent - Retrieve page content and metadata
• ✅ updatePage - Update titles and content with version control
• ✅ deletePage - Remove pages safely
• ✅ getSpaces - List and explore available spaces

Search & Discovery (2 tools):

• ✅ searchPages - Universal search with CQL support
• ✅ getPageVersions - Access page version history

Comment Management (4 tools):

• ✅ getPageComments - Retrieve page comments and replies
• ✅ addComment - Add comments with reply threading
• ✅ updateComment - Edit existing comments
• ✅ deleteComment - Remove comments safely

🎯 Key Capabilities:

• ✅ Production Ready - 100% success rate across all 11 tools
• ✅ 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

🚀 Quick Start

📦 Install from NPM (Recommended)

npm install -g confluence-cloud-mcp-server

⚙️ Quick Configuration

Add to your MCP client configuration:

{
  "mcpServers": {
    "confluence": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "node",
      "args": ["/opt/homebrew/bin/confluence-cloud-mcp-server"],
      "env": {
        "CONFLUENCE_SITE_NAME": "your-site.atlassian.net",
        "CONFLUENCE_EMAIL": "your-email@example.com",
        "CONFLUENCE_API_TOKEN": "your-api-token"
      }
    }
  }
}

💡 Path varies by OS: Use which confluence-cloud-mcp-server to find your installation path

📖 - Follow the step-by-step setup guide

📊 Project Status

Overall Progress: ✅ Sprint 1+2+3 COMPLETED - Full collaboration platform ready
Tools Operational: 11/17 tools fully functional (65% complete)
AI Client Status: ✅ Production Ready - Validated with Cline
Success Rate: 100% functional, 100% MCP protocol compliant

Current Tool Distribution

💡 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://yoursite.atlassian.net/wiki/spaces/DEV/pages/123456

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 v2 - Primary API for page operations
• Confluence REST API v1 - Search and legacy endpoints
• Dual Client Architecture - Optimized for different API versions
• CQL Search Support - Advanced query capabilities
• Basic Authentication - Email + API token secure access

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 Cloud REST API v1 & v2
• Axios - HTTP client with interceptors and error 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

🤖 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

📄 License

MIT License - see for details.

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