Confluence MCP Server

by tqiqbal

4 stars

133 downloads

Not rated

GitHub

Knowledge Base

Description

# Confluence MCP Server A Model Context Protocol (MCP) server for interacting with Confluence Data Center via REST API. This server provides a set of tools that allow AI models to interact with Confluence content. ## Features This MCP server provides the following operations for…

About

Details

Author: tqiqbal
GitHub stars: 4
Downloads: 133
Categories: Knowledge Base

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Confluence MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

From the repository

Clone the repository, install dependencies with pip install -r requirements.txt, and configure a .env file with CONFLUENCE_API_BASE, CONFLUENCE_USERNAME, and CONFLUENCE_PASSWORD. Run in development mode with `mcp dev

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "confluence mcp server": {
            "mcp-confluence-server": {
                "command": "python",
                "args": [
                    "confluence.py"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-confluence-server": {
        "command": "python",
        "args": [
            "confluence.py"
        ]
    }
}

Confluence MCP Server

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

Features

This MCP server provides the following operations for Confluence:

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

Installation

1. Clone this repository
2. Install dependencies:

pip install -r requirements.txt

Configuration

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

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

Adjust the values to match your Confluence instance.

Running the Server

Development Mode (Recommended)

The proper way to run an MCP server is using the MCP CLI tool with the development mode. This will start the MCP Inspector UI which allows 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)

MCP servers are designed to be run with the MCP CLI tool or integrated with Claude Desktop. Direct execution with Python is not the standard way to run an MCP server, but the script includes a fallback mode for testing:

python confluence.py

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

Installing 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 pages.

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

get_page_content

Get the content of a Confluence page.

Parameters:
- pageId: Confluence Page ID

get_page_with_body

Get 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 properties to expand

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 storage format (HTML)
- parentId: Optional parent page ID

update_page

Update an existing page in Confluence.

Parameters:
- pageId: Confluence Page ID
- content: New page content in storage format (HTML)
- title: Optional new title for the page
- spaceKey: Optional space key (only needed if changing space)

delete_page

Delete a page by ID.

Parameters:
- pageId: Confluence Page ID

Example Usage

Once the server is running and connected to an AI model, you can interact with Confluence using natural language. For example:

- "Find all pages in the DOCS space"
- "Get the content of page with ID 123456"
- "Create a new page titled 'Meeting Notes' in the TEAM space with content '<p>Notes from our meeting</p>'"
- "Update page with ID 123456 to have the content '<p>Updated meeting notes</p>'"
- "Update the title of page 123456 to 'Revised Meeting Notes'"

License

MIT

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Description

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Confluence MCP Server

Features

Installation

Configuration

Running the Server

Development Mode (Recommended)

Direct Execution (Not Recommended)

Installing in Claude Desktop

API Reference

execute_cql_search

get_page_content

get_page_with_body

find_pages_by_space

find_page_by_title

create_page

update_page

delete_page

Example Usage

License

Install

More like this

Aws Kb Retrieval Server

Memory

Context 7

MaxKB

AWS MCP Servers

Git (GitHub to MCP)