Registry / crm-productivity / confluence-mcp-server

confluence-mcp-server

library1.3.0jsnpmunverified

Confluence MCP Server (v1.3.0) is a Model Context Protocol server enabling AI agents to search, read, create, update, and upload attachments to Atlassian Confluence (Cloud, Server, Data Center). It provides 15+ tools including CQL search, page sections, anchor-based updates, and preview-confirm two-phase modification to reduce token usage and prevent conflicts. Unique features include section-level updates, Anchor macro support, and automatic version increment. Cloud uses Basic auth, Server supports Bearer or Basic. Requires Node 18+ and a Confluence instance.

crm-productivity http-networking llm-agents

npm install confluence-mcp-server

github ↗package ↗

INSTALL

IMPORT

SIG · CONFLUENCE-MCP-SER

confluence-mcp-server

crm-productivityjavascriptv1.3.0

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default export

✓ import confluenceMCP from 'confluence-mcp-server'

✗ import { confluenceMCP } from 'confluence-mcp-server'

The package exports a single default class/function. Only default import works.

confluenceMCP

✓ const confluenceMCP = require('confluence-mcp-server')

✗ const { confluenceMCP } = require('confluence-mcp-server')

CommonJS require() returns the module.exports directly, not a named export.

Initialize and start the Confluence MCP server with environment variables for authentication.

import confluenceMCP from 'confluence-mcp-server'; const server = confluenceMCP({ mode: 'server', baseUrl: process.env.CONF_BASE_URL ?? 'https://confluence.example.com', username: process.env.CONF_USERNAME ?? '', token: process.env.CONF_TOKEN ?? '' }); // start the MCP server server.start().catch(console.error);

confluence --version

Debug

Known issues

breakingNode.js version < 18 is not supported; engine requirement is >=18

fix

Upgrade Node.js to 18 or later.

affects: <1.0.0

deprecatedconfluence_update_page_section without confirmation (older versions) may cause silent overwrites

fix

Use preview-confirm pattern: confluence_preview_page_section_update followed by confluence_update_page_section_confirmed.

affects: <1.3.0

gotchaCloud mode requires CONF_USERNAME and CONF_TOKEN (API token), not password. Using CONF_PASSWORD will fail.

fix

Set CONF_USERNAME to your email and CONF_TOKEN to your Confluence API token.

affects: >=1.0.0

gotchaServer mode default auth is Bearer, not Basic. Set CONF_AUTH_MODE=basic to use password-based auth.

fix

Configure CONF_AUTH_MODE=basic if using username/password for Confluence Server.

affects: >=1.0.0

gotchaconfluence_update_page_section and confirmed variants perform a full page read + write under the hood; each call counts as two API requests.

fix

Use preview step to avoid unnecessary writes; batch updates when possible.

affects: >=1.0.0

Errors

Common errors & fixes

Error: CONF_MODE must be either 'cloud' or 'server'

Missing or invalid CONF_MODE environment variable.

fix

Set CONF_MODE to 'cloud' or 'server' in your MCP client config or environment.

Error: Cannot read properties of undefined (reading 'start')

The default import is not a class; the module exports a function that returns an object with start().

fix

Use import confluenceMCP from 'confluence-mcp-server' and call confluenceMCP({...}).start()

Error: invalid content type for attachment: must be 'multipart/form-data'

Using the wrong request format for attachment upload; the server expects multipart.

fix

Use confluence_upload_attachment with local file path or base64; the MCP server handles encoding.

Upgrade

Version history

1.3.0latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

44 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/qihaze123/confluence-mcp-server ↗

packagehttps://www.npmjs.com/package/confluence-mcp-server ↗