Confluence Data Center

🚀 Confluence MCP Server

A Model Context Protocol (MCP) server that interacts with Confluence Data Center. This server provides a set of tools that allow AI models to interact with Confluence content.

🚀 Quick Start

The Confluence MCP server is designed to enable interaction between AI models and Confluence content. Here's a brief guide to get you started.

✨ Features

This MCP server provides the following operations for Confluence:

• Execute CQL (Confluence Query Language) searches
• Retrieve page content by ID
• Retrieve page content with the body
• Find pages by space key
• Find pages by title and space key
• Create new pages (with an optional parent page)
• Update existing pages
• Delete pages

📦 Installation

1. Clone this repository.
2. Install the dependencies:

pip install -r requirements.txt

📚 Documentation

Configuration

Create a .env file in the project root directory containing the following variables:

CONFLUENCE_API_BASE=http://localhost:8090/rest/api
CONFLUENCE_USERNAME=your_username
CONFLUENCE_PASSWORD=your_password

Adjust the values according to your Confluence instance.

Running the Server

Development Mode (Recommended)

The correct way to run the MCP server is to start it in development mode using the MCP CLI tool. This will launch the MCP inspector UI, allowing you to test and debug the server:

mcp dev confluence.py

This will start the MCP inspector at http://127.0.0.1:6274 by default.

Direct Execution (Not Recommended)

The MCP server is designed to run with the MCP CLI tool or be integrated into Claude Desktop. Directly executing it with Python is not the standard way to run the MCP server, but the script includes an alternate mode for testing:

python confluence.py

However, this mode has limited functionality and is only for basic testing.

Installation in Claude Desktop

To install the server in Claude Desktop:

mcp install confluence.py

📄 API Reference

execute_cql_search

Execute a CQL query on Confluence to search for pages. Parameters:

• cql: CQL query string
• limit: Number of results to return (default: 10)

get_page_content

Retrieve the content of a Confluence page. Parameters:

• pageId: Confluence page ID

get_page_with_body

Retrieve a page with its body content. Parameters:

• pageId: Confluence page ID

find_pages_by_space

Find pages by space key. Parameters:

• spaceKey: Confluence space key
• limit: Maximum number of results to return (default: 10)
• expand: Optional comma-separated list of expandable properties

find_page_by_title

Find a page by title and space key. Parameters:

• title: Page title
• spaceKey: Confluence space key

create_page

Create a new page in Confluence. Parameters:

• title: Page title
• spaceKey: Confluence space key
• content: Page content (in HTML format)
• parentId: Optional parent page ID

update_page

Update an existing page. Parameters:

• pageId: Confluence page ID
• content: New page content (in HTML format)
• title: Optional new title
• spaceKey: Optional space key (only required when changing the space)

delete_page

Delete a page. Parameters:

• pageId: ID of the page to delete