Skip to main content
Glama
confluence-http-api-mcp

confluence-http-api-mcp

by rkorablin

confluence-http-api-mcp

Read-only MCP server for self-hosted Confluence (Server / Data Center) over the REST API.

Primary use case: let an AI agent read project documentation — search pages, fetch content, navigate page trees.

Requirements

Related MCP server: finviet-confluence-mcp

Configuration

Variable

Required

Description

CONFLUENCE_URL

Yes

Base URL, e.g. https://wiki.it-aces.com

CONFLUENCE_TOKEN

Yes

PAT sent as Authorization: Bearer …

Alias: CONFLUENCE_PAT.

Tools (read-only)

Tool

Purpose

confluence_search

CQL search (space=GAR AND type=page, text ~ "API")

confluence_get_page

Page by content id + plain-text body

confluence_get_page_by_title

Page by space key + exact title

confluence_list_spaces

Discover spaces

confluence_get_page_children

Child pages (doc tree / TOC)

Page bodies are returned as plain text (HTML/storage markup stripped) for easier agent consumption.

Install

From source (GitLab / GitHub)

git clone git@gitlab.greenworm.ru:ai/confluence-http-api-mcp.git
cd confluence-http-api-mcp
npm install

Публичное зеркало: https://github.com/rkorablin/confluence-http-api-mcp.

From npm

npm install confluence-http-api-mcp

Or globally (for npx / CLI usage):

npm install -g confluence-http-api-mcp

Usage

Standalone (stdio)

export CONFLUENCE_URL="https://wiki.it-aces.com"
export CONFLUENCE_TOKEN="..."
node server.mjs

Cursor / MCP host

Add the server to your MCP config (for example .cursor/mcp.json → mcpServers).

Option 1: Local clone

"confluence": {
  "command": "node",
  "args": ["/absolute/path/to/confluence-http-api-mcp/server.mjs"],
  "env": {
    "CONFLUENCE_URL": "https://wiki.it-aces.com",
    "CONFLUENCE_TOKEN": "..."
  }
}

Option 2: npm / npx

If installed globally:

"confluence": {
  "command": "confluence-http-api-mcp",
  "env": {
    "CONFLUENCE_URL": "https://wiki.it-aces.com",
    "CONFLUENCE_TOKEN": "..."
  }
}

Or via npx (рекомендуется для автоподтягивания новых версий):

"confluence": {
  "command": "npx",
  "args": ["--yes", "--prefer-online", "confluence-http-api-mcp@latest"],
  "env": {
    "CONFLUENCE_URL": "https://wiki.it-aces.com",
    "CONFLUENCE_TOKEN": "..."
  }
}

Or via wrapper + secrets file (see ~/.config/ai-mcp pattern used for GitLab/YouTrack).

Typical agent workflow

  1. confluence_list_spaces — find space key (e.g. GAR)

  2. confluence_search with space=GAR AND title ~ "Architecture"

  3. confluence_get_page — read full page text

  4. confluence_get_page_children — walk documentation hierarchy

License

MIT

Available Tools

5 tools
confluence_get_pageA

Get a Confluence page by numeric content id. Returns title, space, ancestors and plain-text body.

Inputs: pageId (required), maxBodyChars.

confluence_get_page_by_titleA

Get a page by space key and exact title (first match).

Inputs: title (required), spaceKey (required), maxBodyChars.

confluence_get_page_childrenA

List child pages under a parent page (table of contents / doc tree).

Inputs: pageId (required), limit.

confluence_list_spacesA

List Confluence spaces accessible with the token.

Inputs: limit, start.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct resource or access pattern: search uses CQL, get_page uses numeric ID, get_page_by_title uses space+title, list_spaces enumerates spaces, and get_page_children navigates hierarchy. No two tools overlap in purpose.

    Naming Consistency5/5

    All tools use a consistent 'confluence_' prefix followed by a verb_noun pattern. The two get_page variants are differentiated by suffix 'by_title', maintaining clarity.

    Tool Count5/5

    Five tools is well-scoped for a read-only Confluence integration; each tool serves a distinct function without redundancy or excessive minimalism.

    Completeness4/5

    The core read operations are present: search, get by ID, get by title, list spaces, and list children. However, there are no mutation endpoints and no space-level detail tool, leaving minor gaps for a full API surface.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers