MCP Server Atlassian Confluence

🚀 Atlassian Confluence MCP Server

This project offers a Model Context Protocol (MCP) server, serving as a bridge between AI assistants (such as Anthropic's Claude, Cursor AI, or other MCP-compatible clients) and your Atlassian Confluence instance. It enables AI to securely access and interact with your Confluence spaces and pages in real-time.

🚀 Quick Start

Installation and Execution

1. Install the global command-line tool via npm

npm install -g @aashari/mcp-server-atlassian-confluence

2. Use sample commands

mcp-atlassian-confluence --help
# View all available commands and their options

mcp-atlassian-confluence list-spaces
# List all Confluence spaces

mcp-atlassian-confluence get-page --page-id 12345678
# Get the content of the specified page

Configuration Guide

Step 1: Install Dependencies

npm install @aashari/mcp-server-atlassian-confluence

Step 2: Start the Server

npx @aashari/mcp-server-atlassian-confluence start

✨ Features

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI systems to securely and contextually connect to external tools and data sources. This server implements MCP for Confluence Cloud, bridging your Confluence data with AI assistants.

Why Use This Server?

• Minimum Input, Maximum Output Concept: Only simple identifiers like spaceKey and pageId are required. Each tool returns comprehensive details without additional flags.
• Full Knowledge Base Access: Provides your AI assistant with full visibility into documents, wikis, and knowledge base content, available in real-time.
• Richly Formatted Content: All page content is automatically converted from Atlassian document format to Markdown, with appropriate headings, tables, lists, and other formatting elements.
• Secure Local Authentication: Credentials are never stored on the server. The server runs locally, so your tokens never leave your device, and you can request the required permissions.
• Intuitive Markdown Content: All page content is returned in an easy-to-read and edit Markdown format.

📦 Installation

Installation and Execution

1. Install the global command-line tool via npm

npm install -g @aashari/mcp-server-atlassian-confluence

2. Use sample commands

mcp-atlassian-confluence --help
# View all available commands and their options

mcp-atlassian-confluence list-spaces
# List all Confluence spaces

mcp-atlassian-confluence get-page --page-id 12345678
# Get the content of the specified page

Configuration Guide

Step 1: Install Dependencies

npm install @aashari/mcp-server-atlassian-confluence

Step 2: Start the Server

npx @aashari/mcp-server-atlassian-confluence start

💻 Usage Examples

Using npx for Quick Execution

npx -y @aashari/mcp-server-atlassian-confluence list-spaces
npx -y @aashari/mcp-server-atlassian-confluence get-page --page 12345678

After Global Installation

mcp-atlassian-confluence list-spaces
# List all Confluence spaces

📚 Documentation

Tool Interfaces (API)

Here are the main tools provided by the MCP server and their usage:

1. list-spaces

List all available Confluence spaces.

{
  "spaces": [
    {
      "id": "123456",
      "key": "MySpaceKey",
      "name": "My Space Name"
    }
  ]
}

2. get-page

Get the content of the specified page.

mcp-atlassian-confluence get-page --page-id 12345678

Return result:

{
  "id": "12345678",
  "title": "My Page Title",
  "content": "# My Page Heading\nThis is the content of my page."
}

3. search

Search Confluence content using CQL.

mcp-atlassian-confluence search --cql "text ~ 'project plan'"

Return result:

{
  "results": [
    {
      "id": "12345679",
      "title": "Project Plan Document",
      "content": "This document outlines our project plan for Q3."
    }
  ]
}

📄 License

ISC License