Confluence MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with Confluence Cloud. This server enables AI assistants to manage Confluence spaces, pages, and content through a standardized interface.

Features

• Space Management
  • List spaces
  • Get space details
• Page Operations
  • Create, read, update pages
  • List pages in a space
  • Convert page content from Confluence storage format to Markdown
• Search & Labels
  • Search content using CQL
  • Manage page labels

Setup

1. Install dependencies:

2. Configure environment variables: Create a .env file with your Confluence credentials:

3. Build the project:

Usage

The server can be integrated with MCP-compatible AI assistants by adding it to their MCP configuration:

Available Tools

Space Tools

• list_spaces: List all spaces in Confluence
• get_space: Get details about a specific space

Page Tools

• list_pages: List pages in a space
• get_page: Get a specific page with its content (now includes Markdown conversion)
• create_page: Create a new page in a space
• update_page: Update an existing page

The get_page tool now automatically converts Confluence storage format content to Markdown, making it easier to work with page content. The conversion handles:

• Headers (h1-h6)
• Lists (ordered and unordered)
• Links
• Emphasis (bold/italic)
• Code blocks
• Tables
• Paragraphs and line breaks

Search & Label Tools

• search_content: Search Confluence content using CQL
• get_labels: Get labels for a page
• add_label: Add a label to a page
• remove_label: Remove a label from a page

Development

This project is written in TypeScript and follows the MCP SDK conventions for implementing server capabilities. The codebase is organized into:

• src/client/ - Confluence API client implementation
• src/handlers/ - MCP tool request handlers
• src/schemas/ - JSON schemas for tool inputs
• src/types/ - TypeScript type definitions
• src/utils/ - Utility functions including content format conversion

License

MIT