Confluence MCP Server

Integrations

  • Provides tools for interacting with Confluence Cloud, enabling management of spaces, pages, and content through features like listing spaces, creating/reading/updating pages, converting Confluence storage format to Markdown, searching content using CQL, and managing page labels.

Confluence Cloud 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

The easiest way to use this server is with the pre-built Docker image:

docker run --rm -i \ -e CONFLUENCE_API_TOKEN=your-api-token \ -e CONFLUENCE_EMAIL=your-email@domain.com \ -e CONFLUENCE_DOMAIN=your-domain.atlassian.net \ ghcr.io/aaronsb/confluence-cloud-mcp:latest

Option 2: Building Locally

  1. Clone the repository:
git clone https://github.com/aaronsb/confluence-cloud-mcp.git cd confluence-cloud-mcp
  1. Build and run using the local build script:
# Build the Docker image ./scripts/build-local.sh # Run the server CONFLUENCE_API_TOKEN=your-token CONFLUENCE_EMAIL=your-email ./scripts/run-local.sh

Option 3: From Source

  1. Install dependencies:
npm install
  1. Configure environment variables: Create a .env file with your Confluence credentials:
CONFLUENCE_DOMAIN=your-domain.atlassian.net CONFLUENCE_EMAIL=your-email@domain.com CONFLUENCE_API_TOKEN=your-api-token
  1. Build the project:
npm run build
  1. Run the server:
node build/index.js

Usage

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

{ "mcpServers": { "confluence": { "command": "docker", "args": ["run", "--rm", "-i", "ghcr.io/aaronsb/confluence-cloud-mcp:latest"], "env": { "CONFLUENCE_DOMAIN": "your-domain.atlassian.net", "CONFLUENCE_EMAIL": "your-email@domain.com", "CONFLUENCE_API_TOKEN": "your-api-token" }, "disabled": false, "autoApprove": [] } } }

Note for AI Assistants: If you're an AI assistant like Cline trying to install this MCP server, please refer to the llms-install.md file for detailed installation instructions.

Available Tools

Space Tools

  • list_confluence_spaces: List all spaces in Confluence
  • get_confluence_space: Get details about a specific space

Page Tools

  • list_confluence_pages: List pages in a space
  • get_confluence_page: Get a specific page with its content (now includes Markdown conversion)
  • create_confluence_page: Create a new page in a space
  • update_confluence_page: Update an existing page

The get_confluence_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_confluence_pages: Search Confluence content using CQL
  • get_confluence_labels: Get labels for a page
  • add_confluence_label: Add a label to a page
  • remove_confluence_label: Remove a label from a page

Note: All tool names follow the [verb]confluence[noun] naming convention for consistency and clarity.

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

CI/CD Pipeline

This project uses GitHub Actions for continuous integration and deployment:

  • Automated testing and linting on pull requests
  • Automatic Docker image builds on main branch commits
  • Multi-architecture image builds (amd64, arm64)
  • Container publishing to GitHub Container Registry

Local Development

For local development, use the provided scripts:

  • ./scripts/build-local.sh: Builds the project and creates a local Docker image
  • ./scripts/run-local.sh: Runs the local Docker image with your credentials

License

MIT

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Enables AI assistants to interact with Confluence Cloud for managing spaces, pages, and content via the Model Context Protocol (MCP).

  1. Features
    1. Setup
      1. Option 1: Using Docker (Recommended)
      2. Option 2: Building Locally
      3. Option 3: From Source
    2. Usage
      1. Available Tools
        1. Space Tools
        2. Page Tools
        3. Search & Label Tools
      2. Development
        1. CI/CD Pipeline
        2. Local Development
      3. License

        Related MCP Servers

        • -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that connects Claude and other MCP clients to Aider, enabling AI assistants to efficiently edit files, create new files, and interact with git repositories through natural language.
          Last updated -
          9
          Python
          The Unlicense
          • Linux
          • Apple
        • -
          security
          F
          license
          -
          quality
          A Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.
          Last updated -
          275
          JavaScript
          • Apple
        • A
          security
          A
          license
          A
          quality
          A Model Context Protocol server that enables AI assistants like Claude to interact with Outline document services, supporting document searching, reading, creation, editing, and comment management.
          Last updated -
          25
          1
          Python
          MIT License
        • 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
          467
          3
          TypeScript
          • Apple

        View all related MCP servers

        ID: mp9zjz01wb