Awesome Confluence MCP Server

🚀 Awesome Confluence MCP Server

The most token-efficient way for AI agents to browse and analyze Confluence documentation.

Topics: mcp-server python confluence-api ai-agents token-optimization markdown fastmcp

📊 Token Savings at a Glance

Typical Confluence Page (2,000 words):

Save 60-80% on LLM tokens by converting Confluence pages to clean Markdown format.

A professional Model Context Protocol (MCP) server that provides token-efficient Confluence integration. Fetch, search, and convert Confluence pages to Markdown, dramatically reducing token consumption while preserving formatting and structure.

💡 Why Markdown Matters

The Token-Saving Advantage:

When working with LLMs, every token counts. Confluence pages in raw HTML format consume 3-5x more tokens than the same content in Markdown:

• HTML Format: ~2,500 tokens for a typical page
• Markdown Format: ~500-800 tokens for the same page
• Savings: 60-80% reduction in token usage

This means:

• ✅ Lower API costs - Fewer tokens = less money spent
• ✅ Faster responses - Less data to process
• ✅ Better context - Fit more pages in your context window
• ✅ Cleaner output - Markdown is easier for LLMs to understand and work with

✨ Features

• 🔍 List Spaces - Browse all accessible Confluence spaces
• 🔎 Search Pages - Find pages by title or content with optional space filtering
• 📄 Fetch as Markdown - Convert any Confluence page to clean, token-efficient Markdown
• 🔐 Secure Authentication - Uses Atlassian API tokens (never store passwords)
• ⚡ Fast & Reliable - Built with FastMCP for optimal performance
• 🛡️ Error Handling - Comprehensive validation and helpful error messages

🚀 Quick Start

1. Installation

# Clone the repository
git clone https://github.com/mazhar480/awesome-confluence-mcp.git
cd awesome-confluence-mcp

# Install with pip
pip install -e .

2. Get Your Atlassian API Token

1. Go to Atlassian API Tokens
2. Click Create API token
3. Give it a name (e.g., "MCP Server")
4. Copy the token (you won't see it again!)

3. Configure Environment

# Copy the example file
cp .env.example .env

# Edit .env with your credentials
CONFLUENCE_URL=https://your-domain.atlassian.net
CONFLUENCE_EMAIL=your.email@example.com
CONFLUENCE_API_TOKEN=your_api_token_here

4. Configure Your MCP Client

For Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "confluence": {
      "command": "python",
      "args": ["-m", "server"],
      "cwd": "/path/to/awesome-confluence-mcp",
      "env": {
        "CONFLUENCE_URL": "https://your-domain.atlassian.net",
        "CONFLUENCE_EMAIL": "your.email@example.com",
        "CONFLUENCE_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

For Cline (VS Code Extension)

Add to your MCP settings:

{
  "confluence": {
    "command": "python",
    "args": ["-m", "server"],
    "cwd": "/path/to/awesome-confluence-mcp"
  }
}

Make sure your .env file is configured in the project directory.

🔧 Available Tools

`list_spaces`

List all Confluence spaces you have access to.

Parameters:

• limit (optional): Maximum number of spaces to return (1-100, default: 25)

Example:

List my Confluence spaces

Returns:

{
  "total": 3,
  "spaces": [
    {
      "key": "DOCS",
      "name": "Documentation",
      "type": "global",
      "id": "123456",
      "url": "https://your-domain.atlassian.net/wiki/spaces/DOCS"
    }
  ]
}

`search_pages`

Search for pages by title or content.

Parameters:

• query (required): Search term to match against titles and content
• space_key (optional): Limit search to a specific space
• limit (optional): Maximum results to return (1-50, default: 10)

Example:

Search for pages about "API documentation" in the DOCS space

Returns:

{
  "total": 5,
  "query": "API documentation",
  "space_key": "DOCS",
  "pages": [
    {
      "id": "789012",
      "title": "REST API Documentation",
      "type": "page",
      "space": {
        "key": "DOCS",
        "name": "Documentation"
      },
      "version": 12,