Confluence MCP Server

by tqiqbal

Integrations

  • Provides tools for interacting with Confluence Data Center via REST API, enabling search with CQL, retrieving page content, finding pages by space or title, creating new pages, updating existing pages, and deleting pages.

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

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.

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 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 'Notes from our meeting'"
  • "Update page with ID 123456 to have the content 'Updated meeting notes'"
  • "Update the title of page 123456 to 'Revised Meeting Notes'"

License

MIT

-
security - not tested
F
license - not found
-
quality - not tested

A server that enables AI models to interact with Confluence Data Center through REST API, providing operations like searching, reading, creating, updating, and deleting pages.

  1. Features
    1. Installation
      1. Configuration
        1. Running the Server
          1. Development Mode (Recommended)
          2. Direct Execution (Not Recommended)
          3. Installing in Claude Desktop
        2. API Reference
          1. execute_cql_search
          2. get_page_content
          3. get_page_with_body
          4. find_pages_by_space
          5. find_page_by_title
          6. create_page
          7. update_page
          8. delete_page
        3. Example Usage
          1. License

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              A server that enhances AI assistants with the ability to update your JSON Resume by analyzing your coding projects, automatically extracting skills and generating professional descriptions.
              Last updated -
              3
              32
              39
              TypeScript
              The Unlicense
              • Apple
              • Linux
            • -
              security
              F
              license
              -
              quality
              A server that enables AI systems to browse, retrieve content from, and interact with web pages through the Model Context Protocol.
              Last updated -
            • A
              security
              F
              license
              A
              quality
              A Model Context Protocol server that enables AI assistants like Claude to access and search Atlassian Confluence content, allowing integration with your organization's knowledge base.
              Last updated -
              5
              1,644
              5
              TypeScript
              • Apple
            • A
              security
              A
              license
              A
              quality
              A Model Context Protocol server that enables AI assistants to interact with Confluence content, supporting operations like retrieving, searching, creating, and updating pages and spaces.
              Last updated -
              9
              3
              TypeScript
              MIT License

            View all related MCP servers

            ID: j7fcq23t0r