Confluence

You can connect your AI tools to Confluence through a Go‑based MCP server that lets you search, read, create, and update Confluence content. This MCP server acts as a bridge between AI assistants and the Confluence API, enabling seamless interactions with pages, spaces, comments, and permissions.

How to use

Connect a client to the Confluence MCP server using a standard MCP configuration. You will run the MCP server locally (stdio) or via Docker, authenticate with your Confluence credentials, and then point your AI assistant to the MCP transport. The server exposes endpoints for searching pages, retrieving page details and content, creating and updating pages, listing spaces, and fetching comments.

How to install

Prerequisites: ensure you have a supported runtime environment and Docker installed if you plan to run the Docker image.

Option 1 - Install from binary (stdio)

1. Download the suitable binary for your platform from the release assets. Platforms include Linux, macOS, and Windows. Then make the binary executable and place it in your PATH.

2. Example commands you would run after download (adjust paths to your environment):

chmod +x confluence-mcp_* sudo mv confluence-mcp_* /usr/local/bin/confluence-mcp

Option 2 - Install with Go (stdio)

1. Ensure you have Go installed on your system. If not, install Go from the official Go website.

2. Run the Go install command to fetch the Confluence MCP server binary.

go install github.com/nguyenvanduocit/confluence-mcp@latest

Option 3 - Run with Docker (stdio)

1. Pull the pre-built image from the container registry or build it locally.

Pull the image:

docker pull ghcr.io/nguyenvanduocit/confluence-mcp:latest

Or build locally:

docker build -t confluence-mcp .

Configuration

Environment variables required for authentication are used by the MCP server to connect to Confluence.

Required environment variables (set in your environment or in a .env file):

ATLASSIAN_HOST=your_confluence_host ATLASSIAN_EMAIL=your_email ATLASSIAN_TOKEN=your_token

The MCP server supports two transport methods. The standard I/O (stdio) transport is the default. For HTTP-based integrations, you can run the server with an HTTP transport by enabling the http port.

Usage examples

Using Claude Desktop or Cursor with stdio transport, you configure your MCP client to launch the Confluence MCP and point it to the environment file for credentials.

Example stdio configuration for a client (shown as JSON configuration):

{
  "mcpServers": {
    "confluence": {
      "name": "confluence",
      "type": "stdio",
      "command": "/path/to/confluence-mcp",
      "args": ["-env", "/path/to/.env"],
      "env": [
        {"name": "ATLASSIAN_HOST", "value": "your_confluence_host"},
        {"name": "ATLASSIAN_EMAIL", "value": "your_email"},
        {"name": "ATLASSIAN_TOKEN", "value": "your_token"}
      ]
    }
  }
}

Additional examples

Running the MCP server via Docker also uses stdio transport. The configuration below shows how to start the server with Docker and pass credentials through environment variables.

Example Docker configuration for a client (shown as JSON configuration):

{
  "mcpServers": {
    "confluence_docker": {
      "name": "confluence_docker",
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "ATLASSIAN_HOST=your_confluence_host",
        "-e", "ATLASSIAN_EMAIL=your_email",
        "-e", "ATLASSIAN_TOKEN=your_token",
        "ghcr.io/nguyenvanduocit/confluence-mcp:latest"
      ],
      "env": [
        {"name": "ATLASSIAN_HOST", "value": "your_confluence_host"},
        {"name": "ATLASSIAN_EMAIL", "value": "your_email"},
        {"name": "ATLASSIAN_TOKEN", "value": "your_token"}
      ]
    }
  }
}

Available tools

search_page

Search Confluence pages and spaces using CQL to locate content quickly.

get_page

Retrieve a Confluence page's content and metadata, including its body and version information.

create_page

Create a new Confluence page with a given title, content, and metadata in a specified space.

update_page

Update the content or metadata of an existing Confluence page.

get_comments

Fetch comments on a Confluence page for discussion or review.

list_spaces

List all spaces in the Confluence instance to help you locate targets.