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.

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

1. Clone this repository
2. Install dependencies:

pip install -r requirements.txt

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

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

Adjust the values to match your Confluence instance.

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 https://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.

To install the server in Claude Desktop:

mcp install confluence.py

Execute a CQL query on Confluence to search pages.

Parameters:

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

Get the content of a Confluence page.

Parameters:

• pageId: Confluence Page ID

Get a page with its body content.

Parameters:

• pageId: Confluence Page ID

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 a page by title and space key.

Parameters:

• title: Page title
• spaceKey: Confluence Space Key

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 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 a page by ID.

Parameters:

• pageId: Confluence Page ID

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'"

MIT