Confluence

This MCP server provides programmatic access to a Confluence instance via a FastMCP-based API. Through the available Python-based endpoints, you can list spaces, fetch and manage page content, perform Confluence Query Language (CQL) searches, and navigate the page hierarchy inside specific spaces. The server authenticates requests using a token-based system and exposes methods such as list_spaces, get_page_content, search_content, and list_pages_in_space, enabling you to integrate Confluence data into your workflows or chat-based assistants. To start, configure your environment with your Confluence instance URL, a user email, and an API token, then run the server with python confluence.py. You can then invoke the exposed methods from your client or MCP-enabled tooling to retrieve spaces, page data, or search results in a structured format.

Prerequisites:

• Python 3.8 or newer
• pip installed
• Access to a Confluence instance with API permissions

Installation steps:

1. Clone the repository git clone https://github.com/MahithChigurupati/Confluence-MCP-Server.git cd Confluence-MCP-Server

2. (Recommended) Create and activate a virtual environment python -m venv venv source venv/bin/activate # macOS/Linux .\venv\Scripts\activate # Windows

3. Install dependencies pip install -r requirements.txt

4. Create and configure environment variables cp .env.example .env Edit .env to set CONFLUENCE_BASE_URL, USERNAME, API_TOKEN

5. Run the server python confluence.py

Optional Smithery-based installation steps (if using Smithery): npx -y @smithery/cli install @MahithChigurupati/confluence-mcp-server --client claude

Notes and tips:

• Ensure CONFLUENCE_BASE_URL points to the Confluence REST API endpoint for your instance (commonly /rest/api).
• The API token should be generated from your Atlassian account and kept secure; avoid exposing it in logs or repository files.
• If you encounter 401/403 errors, verify that USERNAME matches the Atlassian account email and that the API token is valid.
• For CI environments, consider using environment variables securely rather than storing credentials in files.
• The server relies on standard Confluence permissions; ensure the authenticated user has access to the spaces and pages you query.
• If you change the base URL or tokens, restart the MCP server to apply changes.