confluence-mcp

Confluence MCP

A Go-based Model Context Protocol (MCP) server for integrating AI assistants with Atlassian Confluence. This tool provides a seamless interface for interacting with the Confluence API through the standardized MCP, enabling AI models to search, retrieve, create, and update Confluence content.

Features

• Search Confluence pages and spaces
• Get page details and content
• Create new pages and spaces
• Update existing pages
• Manage page permissions and metadata

Installation

There are several ways to install the Script Tool:

Option 1: Download from GitHub Releases

1. Visit the GitHub Releases page
2. Download the binary for your platform:
   • confluence-mcp_linux_amd64 for Linux
   • confluence-mcp_darwin_amd64 for macOS
   • confluence-mcp_windows_amd64.exe for Windows
3. Make the binary executable (Linux/macOS):

   chmod +x confluence-mcp_*
   

4. Move it to your PATH (Linux/macOS):

   sudo mv confluence-mcp_* /usr/local/bin/confluence-mcp
   

Option 2: Go install

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

Option 3: Docker

Using Docker directly

1. Pull the pre-built image from GitHub Container Registry:

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

2. Or build the Docker image locally:

   docker build -t confluence-mcp .
   

Environment Variables

The following environment variables are required for authentication:

ATLASSIAN_HOST=your_confluence_host
ATLASSIAN_EMAIL=your_email
ATLASSIAN_TOKEN=your_token

You can set these directly in the Docker run command (recommended) or through a .env file (for local development).

Config

Environment

1. Set up environment variables in .env file:

ATLASSIAN_HOST=your_atlassian_host
ATLASSIAN_EMAIL=your_email
ATLASSIAN_TOKEN=your_token

Claude, cursor

{
  "mcpServers": {
    "script": {
      "command": "/path-to/script-mcp",
      "args": ["-env", "path-to-env-file"]
    }
  }
}

Example: Run with Docker in mcpServers config

{
  "mcpServers": {
    "confluence": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "ATLASSIAN_HOST=your_confluence_instance.atlassian.net",
        "-e", "ATLASSIAN_EMAIL=your_email@example.com",
        "-e", "ATLASSIAN_TOKEN=your_atlassian_api_token",
        "ghcr.io/nguyenvanduocit/confluence-mcp:latest"
      ]
    }
  }
}

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.