@mcp-monorepo/confluence

MCP server for Confluence API tools

This package provides a set of tools to interact with a Confluence instance. It allows a model to read, search, create, and update Confluence pages and spaces, acting as a comprehensive bridge to a Confluence-based knowledge base.

Key Features

• Full Page Lifecycle: Create, read, and update Confluence pages.
• Space & Page Discovery: List available spaces and the pages within them.
• Powerful Search: Leverage Confluence Query Language (CQL) for advanced content searching.
• Direct API Integration: Communicates directly with the Confluence REST API using a personal access token for authentication.
• Optional Insecure TLS: Can be configured to disable TLS certificate validation via the CONFLUENCE_INSECURE_SKIP_VERIFY environment variable. This is useful for connecting to self-hosted instances with self-signed certificates, but should be used with caution.

Usage

You can run this MCP server directly using npx for local testing:

npx @mcp-monorepo/confluence@latest

To integrate this server with a compatible AI model (like Claude), provide the following MCP server configuration:

{
  "mcpServers": {
    "confluence": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-monorepo/confluence"
      ],
      "env": {
        "CONFLUENCE_BASE_URL": "<Your CONFLUENCE_BASE_URL Here>",
        "CONFLUENCE_TOKEN": "<Your CONFLUENCE_TOKEN Here>",
        "CONFLUENCE_COOKIE": "<Your CONFLUENCE_COOKIE Here>",
        "CONFLUENCE_API_VERSION": "1",
        "CONFLUENCE_INSECURE_SKIP_VERIFY": "false"
      }
    }
  }
}

Environment Variables

| Variable | Description | Default | | :--- | :--- | :--- | | CONFLUENCE_BASE_URL | The base URL for your Confluence instance API (e.g., https://your-domain.atlassian.net/wiki). | <required> | | CONFLUENCE_TOKEN | A Confluence Personal Access Token (PAT) for API authentication. Either CONFLUENCE_TOKEN or CONFLUENCE_COOKIE must be set (not both). | <required (mutually exclusive with CONFLUENCE_COOKIE)> | | CONFLUENCE_COOKIE | A Confluence session cookie for API authentication. Either CONFLUENCE_TOKEN or CONFLUENCE_COOKIE must be set (not both). Useful when connecting to on-premise Confluence instances. | <required (mutually exclusive with CONFLUENCE_TOKEN)> | | CONFLUENCE_API_VERSION | Confluence REST API version to use: '1' or '2'. Default: '1'. Version 2 provides cursor-based pagination, native ADF support, and enhanced search capabilities. | 1 | | CONFLUENCE_INSECURE_SKIP_VERIFY | Set to 'true' to disable TLS certificate validation. Use with caution, as this is a security risk. Recommended only for self-hosted Confluence instances with self-signed certificates. | false |

Tools

open-page

Open Confluence Page - Fetch a Confluence page content by pageId. Returns Markdown format in v2 (converted from ADF), storage HTML format in v1.

Input Schema

| Property | Type | Description | | :--- | :--- | :--- | | pageId | string | The Confluence page ID to fetch |

list-pages-of-space

List Pages of Space - List all Confluence pages in a given space. Supports both offset-based pagination (v1) and cursor-based pagination (v2).

Input Schema

| Property | Type | Description | | :--- | :--- | :--- | | spaceKey | string | The Confluence space key (not the id) to fetch pages from. Example: "MYSPACE" | | limit | integer | Number of results to return (default 50) | | start | integer | Result offset for pagination - v1 only (default 0) | | cursor | string | Cursor for next page - v2 only (from previous response) |

list-spaces

List Confluence Spaces - List all Confluence spaces. Supports both offset-based pagination (v1) and cursor-based pagination (v2).

Input Schema

| Property | Type | Description | | :--- | :--- | :--- | | limit | integer | Number of results to return (default 50) | | start | integer | Result offset for pagination - v1 only (default 0) | | cursor | string | Cursor for next page - v2 only (from previous response) |

create-page

Create Confluence Page - Create a new page in Confluence. In API v2, content should be Markdown (auto-converted to ADF). In API v1, content should be storage HTML format.

Input Schema

| Property | Type | Description | | :--- | :--- | :--- | | spaceKey | string | The Confluence space key | | title | string | The title of the new page | | content | string | The content of the new page (Markdown in v2, storage HTML in v1) | | parentId | string | Optional parent page ID |

update-page

Update Confluence Page - Update the title and/or content of a Confluence page. In API v2, content should be Markdown (auto-converted to ADF). In API v1, content should be storage HTML format.

Input Schema

| Property | Type | Description | | :--- | :--- | :--- | | pageId | string | The Confluence page ID to update | | newTitle | string | The new title for the page | | newContent | string | The new content for the page (Markdown in v2, storage HTML in v1) |

search-cql

Search Confluence with CQL - Search Confluence content using a CQL (Confluence Query Language) query. API v1 only - use search-pages for v2.

Input Schema

| Property | Type | Description | | :--- | :--- | :--- | | cqlQuery | string | Confluence Query Language string | | limit | integer | Number of results to return (default 10) | | start | integer | Result offset for pagination (default 0) |

Other MCP Servers

This monorepo contains several other MCP server packages available on npm. Each provides a distinct set of tools for use with the Model Context Protocol.

• @mcp-monorepo/file-browser: MCP server for file system browsing and manipulation (search, ls, tree, grep, open, write, move, mkdir)
• @mcp-monorepo/ics: MCP server for calendar tools using ICS/ical feeds
• @mcp-monorepo/jira: MCP server for Jira tools (JQL, issue management, etc.).
• @mcp-monorepo/location: MCP server for location-based tools using IP address lookup
• @mcp-monorepo/mail: MCP server for mail tools (fetch, read, search, mark as seen).
• @mcp-monorepo/maps: MCP server providing geospatial tools powered by the Stadia Maps API.
• @mcp-monorepo/notion-query: MCP server for querying Notion data sources.
• @mcp-monorepo/npm: MCP server for npm command tools (run scripts, install packages, list scripts)
• @mcp-monorepo/slack: Slack MCP to access workspace without bot account or app
• @mcp-monorepo/weather: Weather MCP tools (geocoding, weather-by-coords) for ModelContextProtocol.

Recent Changes

Version 1.2.0

• 7f6ee0a: generate READMEs for packages via MCP introspection, add docgen and scripts, bump zod to v4 with schema fixes, improve syslog/logger graceful shutdown

Version 1.1.4

• fd22b00: Fixed yarn versioning during publish

Version 1.1.3

• Updated dependencies [7929a55]

Authors

• The MCP Monorepo Team

License

This project is licensed under the AGPL-3.0-only License. See the LICENSE file for details.