Confluence MCP Server

🌐 Confluence MCP Server

A powerful Model Context Protocol (MCP) server that brings Atlassian Confluence integration directly to any editor or application that supports MCP

✨ Features

🚀 New in v0.3.0 - Optimized Architecture

• 9 Strategic MCP Tools - Optimized from 8 tools with enhanced workflow capabilities
• Domain-Based Architecture - Clean separation into 3 domains: Spaces, Pages, and Search
• Enhanced Navigation - New tools for space lookup, page hierarchy, and content discovery
• Improved Performance - 1871 tests passing with optimized build process

📚 **Access Confluence Directly From Your Editor**

• Browse your Confluence spaces without leaving your IDE
• Get detailed page information with formatted content
• Navigate page hierarchies with child page discovery
• Create, update, and manage Confluence content directly

🔍 **Powerful Search Capabilities**

• Search pages using text queries or advanced CQL (Confluence Query Language)
• Support for space filtering, content type filtering, and result ordering
• Rich markdown formatting with page previews and direct links
• Renamed confluence_search_pages to confluence_search for simplicity

📝 **Smart Content Processing**

• Automatic conversion of Confluence's storage format to readable markdown
• Support for formatted text, tables, macros, and attachments
• Full CRUD operations for page management
• Strategic workflow tools for better user experience

🚀 Quick Start

Installation

The easiest way to use this MCP server is to install it directly via npm/bunx. No local setup required!

For Claude Desktop

Add this configuration to your Claude Desktop MCP settings:

{
  "mcpServers": {
    "Confluence Tools": {
      "command": "bunx",
      "args": ["-y", "@dsazz/mcp-confluence@latest"],
      "env": {
        "CONFLUENCE_HOST_URL": "https://your-domain.atlassian.net",
        "CONFLUENCE_USER_EMAIL": "your-email@example.com",
        "CONFLUENCE_API_TOKEN": "your-confluence-api-token"
      }
    }
  }
}

For Cursor IDE

Add this configuration to your Cursor IDE MCP settings:

{
  "mcpServers": {
    "Confluence Tools": {
      "command": "bunx",
      "args": ["-y", "@dsazz/mcp-confluence@latest"],
      "env": {
        "CONFLUENCE_HOST_URL": "https://your-domain.atlassian.net",
        "CONFLUENCE_USER_EMAIL": "your-email@example.com",
        "CONFLUENCE_API_TOKEN": "your-confluence-api-token"
      }
    }
  }
}

For Any MCP Client

Use this configuration pattern for any MCP-compatible client:

{
  "mcpServers": {
    "Confluence Tools": {
      "command": "bunx",
      "args": ["-y", "@dsazz/mcp-confluence@latest"],
      "env": {
        "CONFLUENCE_HOST_URL": "https://your-domain.atlassian.net",
        "CONFLUENCE_USER_EMAIL": "your-email@example.com",
        "CONFLUENCE_API_TOKEN": "your-confluence-api-token"
      }
    }
  }
}

🔑 Getting Your Confluence API Token

1. Go to Atlassian API Tokens
2. Click "Create API token"
3. Give it a name (e.g., "MCP Confluence")
4. Copy the token and use it in your configuration
5. Important: Use the token exactly as provided (no quotes needed in the env section)

Alternative: Using npx instead of bunx

If you prefer npx over bunx, you can also use:

{
  "mcpServers": {
    "Confluence Tools": {
      "command": "npx",
      "args": ["-y", "@dsazz/mcp-confluence@latest"],
      "env": {
        "CONFLUENCE_HOST_URL": "https://your-domain.atlassian.net",
        "CONFLUENCE_USER_EMAIL": "your-email@example.com",
        "CONFLUENCE_API_TOKEN": "your-confluence-api-token"
      }
    }
  }
}

Testing Your Setup

After adding the configuration:

1. Restart your MCP client (Claude Desktop, Cursor, etc.)
2. Try this command to test the connection:

   Show me my Confluence spaces.
   

That's it! You're ready to use Confluence directly from your MCP client.

🛠️ Development Setup

# Clone the repo