{"id":18240,"library":"confluence-mcp-server","title":"Confluence MCP Server","description":"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.","status":"active","version":"1.3.0","language":"javascript","source_language":"en","source_url":"https://github.com/qihaze123/confluence-mcp-server","tags":["javascript","mcp","model-context-protocol","confluence","atlassian","cloud","server","datacenter","typescript"],"install":[{"cmd":"npm install confluence-mcp-server","lang":"bash","label":"npm"},{"cmd":"yarn add confluence-mcp-server","lang":"bash","label":"yarn"},{"cmd":"pnpm add confluence-mcp-server","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"The package exports a single default class/function. Only default import works.","wrong":"import { confluenceMCP } from 'confluence-mcp-server'","symbol":"default export","correct":"import confluenceMCP from 'confluence-mcp-server'"},{"note":"CommonJS require() returns the module.exports directly, not a named export.","wrong":"const { confluenceMCP } = require('confluence-mcp-server')","symbol":"confluenceMCP","correct":"const confluenceMCP = require('confluence-mcp-server')"}],"quickstart":{"code":"import confluenceMCP from 'confluence-mcp-server';\n\nconst server = confluenceMCP({\n  mode: 'server',\n  baseUrl: process.env.CONF_BASE_URL ?? 'https://confluence.example.com',\n  username: process.env.CONF_USERNAME ?? '',\n  token: process.env.CONF_TOKEN ?? ''\n});\n\n// start the MCP server\nserver.start().catch(console.error);","lang":"typescript","description":"Initialize and start the Confluence MCP server with environment variables for authentication."},"warnings":[{"fix":"Upgrade Node.js to 18 or later.","message":"Node.js version < 18 is not supported; engine requirement is >=18","severity":"breaking","affected_versions":"<1.0.0"},{"fix":"Use preview-confirm pattern: confluence_preview_page_section_update followed by confluence_update_page_section_confirmed.","message":"confluence_update_page_section without confirmation (older versions) may cause silent overwrites","severity":"deprecated","affected_versions":"<1.3.0"},{"fix":"Set CONF_USERNAME to your email and CONF_TOKEN to your Confluence API token.","message":"Cloud mode requires CONF_USERNAME and CONF_TOKEN (API token), not password. Using CONF_PASSWORD will fail.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Configure CONF_AUTH_MODE=basic if using username/password for Confluence Server.","message":"Server mode default auth is Bearer, not Basic. Set CONF_AUTH_MODE=basic to use password-based auth.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use preview step to avoid unnecessary writes; batch updates when possible.","message":"confluence_update_page_section and confirmed variants perform a full page read + write under the hood; each call counts as two API requests.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Set CONF_MODE to 'cloud' or 'server' in your MCP client config or environment.","cause":"Missing or invalid CONF_MODE environment variable.","error":"Error: CONF_MODE must be either 'cloud' or 'server'"},{"fix":"Use import confluenceMCP from 'confluence-mcp-server' and call confluenceMCP({...}).start()","cause":"The default import is not a class; the module exports a function that returns an object with start().","error":"Error: Cannot read properties of undefined (reading 'start')"},{"fix":"Use confluence_upload_attachment with local file path or base64; the MCP server handles encoding.","cause":"Using the wrong request format for attachment upload; the server expects multipart.","error":"Error: invalid content type for attachment: must be 'multipart/form-data'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}