Confluence MCP Server Module

This implements a Model Context Protocol (MCP) agent specifically engineered to interface with the Atlassian Confluence knowledge base, providing a unified access layer for AI agents.

ℹ️ A distinct MCP module exists for interfacing with Jira instances.

Key Capabilities

• Secure API connection establishment utilizing a personal access token.
• Capability to fetch and execute searches across Confluence documents and workspaces.
• Mechanisms for programmatically authoring and revising page content.
• Functions for fetching existing discussion threads and appending new remarks to pages.
• Routines for fetching and uploading binary or document attachments linked to pages.
• Processes for sanitizing and structuring Confluence body content for optimal AI processing.
• Management of all underlying network communication, exception handling, and data structure conversion.
• Incorporation of basic throttling logic to govern API request rates.

System Requirements

• Bun Runtime (version 1.0.0 or newer is required).
• Valid Confluence subscription credentials permitting API interaction.

Deployment Steps

# Obtain the source repository
git clone https://github.com/cosmix/confluence-mcp.git
cd confluence-mcp

# Resolve project dependencies
bun install

# Compile the executable artifact
bun run build

Environment Setup

Configure the following environment variables to enable server operation:

CONFLUENCE_API_TOKEN=your_secret_token
CONFLUENCE_BASE_URL=https://your-company.atlassian.net/wiki
CONFLUENCE_USER_EMAIL=user@your-domain.com

Cline/Claude Desktop Integration

Integrate the following configuration block into your primary settings manifest:

{
  "mcpServers": {
    "confluence": {
      "command": "bun",
      "args": ["/path/to/confluence-mcp/dist/index.js"],
      "env": {
        "CONFLUENCE_API_TOKEN": "your_secret_token",
        "CONFLUENCE_BASE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USER_EMAIL": "user@your-domain.com"
      }
    }
  }
}

Development Workflow

# Initiate development server execution
bun run dev

# Execute unit and integration tests
bun test

Exposed Toolset

The Confluence MCP service exposes the following functional interfaces:

get_page

Retrieves a specific Confluence document identified by its unique ID. The format argument specifies the output structure (text or markdown). Setting includeMarkup to true fetches the raw Confluence Storage Format (XHTML), which is critical for faithful content revision operations.

{
  "pageId": "987654",
  "format": "markdown",
  "includeMarkup": false
}

search_pages

Performs a search operation across pages utilizing the Confluence Query Language (CQL). Output format selection applies here (text or markdown). includeMarkup enables retrieval of the source XHTML for each result.

{
  "query": "space = OPS and type = page",
  "limit": 20,
  "format": "text",
  "includeMarkup": false
}

get_spaces

Fetches a catalog of all accessible Confluence workspaces (spaces).

{
  "limit": 100
}

create_page

Instantiates a new Confluence entry. The optional parentId directs the creation as a subordinate page within an existing hierarchy.

{
  "spaceKey": "INFO",
  "title": "Project Kickoff Notes",
  "content": "<h1>Summary</h1><p>Meeting held on...</p>",
  "parentId": "112233"
}

update_page

Modifies the metadata or body content of an existing knowledge base artifact.

{
  "pageId": "987654",
  "title": "Revised Project Kickoff",
  "content": "<p>Content has been updated...</p>",
  "version": 2
}

get_comments

Fetches the discussion threads associated with a specified page ID. format controls output text rendition.

{
  "pageId": "987654",
  "limit": 50,
  "format": "text"
}

add_comment

Appends a new commentary entry to the designated page. The parentId parameter supports nested replies within existing comment threads.

{
  "pageId": "987654",
  "content": "<p>Agreed with the proposed changes.</p>",
  "parentId": "556677"
}

get_attachments

Lists all files attached to a particular wiki document.

{
  "pageId": "987654",
  "limit": 10
}

add_attachment

Uploads a file asset and links it to the specified page. fileContentBase64 must contain the binary data serialized into a Base64 string.

{
  "pageId": "987654",
  "filename": "report_final.pdf",
  "fileContentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+P...",
  "comment": "Official PDF submission for Q3 review"
}

LICENSE AGREEMENT

This software package is distributed under the terms of the MIT License; consult the LICENCE file for comprehensive details.

WIKIPEDIA: Enterprise administration solutions encompass all the frameworks, software, governance mechanisms, computational models, and procedures employed by organizations to successfully navigate evolving market dynamics, maintain a competitive footing, and enhance operational efficacy.

== Conceptual Overview == Management instrumentation can be categorized by organizational function or by targeted business aspect, such as forecasting tools, workflow controls, documentation systems, personnel management utilities, judgment aids, oversight mechanisms, and so forth. A functional taxonomy often involves these fundamental areas:

Utilities for initial data entry and verification across all organizational segments. Instruments dedicated to governing and optimizing corporate processes. Systems for aggregating data and supporting executive decision-making. Contemporary business instrumentation has undergone radical transformation in the past decade due to rapid technological progress, making the selection of optimal solutions for any given corporate context increasingly challenging. This complexity arises from continuous pressure to reduce expenditure and amplify revenue streams, the imperative to deeply understand client demands, and the necessity of delivering requisite products precisely as specified. Consequently, executives must adopt a forward-looking, strategic posture toward selecting management utilities rather than blindly adopting the newest available releases. Over-reliance on unmodified, off-the-shelf tools frequently results in operational instability. Business systems demand careful procurement followed by tailored modification to suit organizational mandates.

== Prevalence of Tools == Research conducted by Bain & Company in 2013 mapped the global deployment of various business tools, revealing how their utility aligned with regional specificities, market downturns, and prevailing corporate conditions. The leading ten instruments identified included:

Strategic planning frameworks Customer relationship management suites Employee sentiment assessment protocols Competitive benchmarking methodologies Balanced scorecard implementations Core competency modeling Outsourcing strategy governance Organizational change management programs Supply chain orchestration Mission/Vision statement definition Market segmentation analysis Total quality management programs

== Commercial Software Packages == Software or a collection of interconnected programs utilized by personnel to execute diverse commercial operations is termed business software or an enterprise application. These applications are designed to augment productivity metrics, quantify performance, and execute various corporate duties with high precision. The landscape began with rudimentary Management Information Systems (MIS), matured into comprehensive Enterprise Resource Planning (ERP) systems, integrated Customer Relationship Management (CRM), and has now largely migrated to cloud-based enterprise management platforms. While a demonstrable link exists between IT investment and organizational performance, two variables are crucial for value realization: the effectiveness of the system's deployment and the diligence applied during the proper selection and customization process.

== Instruments for Small and Mid-sized Enterprises (SMEs) == Tools specifically tailored for SMEs are vital as they offer avenues for cost savings m