confluence-mcp
Integrates with Atlassian Confluence (Server, Data Center, and Cloud via an adapter seam) through its REST API, exposing compact page listings, pagination metadata, and conflict-safe page writes to AI agents.
Provides a Model Context Protocol server for Atlassian Confluence, with a working Server/Data Center provider (REST API) supporting paginated page listings normalized into a common PageMeta convention, compact token-efficient page cards instead of raw REST payloads, and optimistic-lock-safe write operations that re-fetch and retry once on HTTP 409 version conflicts. Supports personal access token or basic auth, custom headers, and a read-only mode that hides write tools. Confluence Cloud calls currently return a structured PROVIDER_UNAVAILABLE error until the Cloud adapter is implemented.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@confluence-mcp list pages in the engineering space updated this week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
confluence-mcp
Deployment-agnostic Model Context Protocol server (stdio) for Atlassian Confluence.
Confluence Server / Data Center — fully working provider (REST base
/rest/api, zero-basedstart/limitpagination, numbered page envelopes withsize).Confluence Cloud — adapter seam only. Every call returns a structured
PROVIDER_UNAVAILABLEerror until the Cloud v2 adapter lands in Phase 4.
Core features carried over from the shared MCP core design:
Compact cards — raw REST payloads are never forwarded to the LLM; list/detail projections emit small, token-cheap JSON cards.
Pagination-aware listings — page envelopes are normalized into a single
PageMetaconvention (isLastPage,nextPageStart,nextCursor) regardless of whether the provider pages by numbered offsets or opaque cursors.Optimistic-lock-safe writes — Confluence pages carry a
version; on HTTP 409 the current page is re-fetched and the write is retried exactly once.
Configuration (environment)
Variable | Meaning |
| Instance base URL, e.g. |
|
|
| Personal access token → |
| Credential pair → |
|
|
| Comma-separated |
Either CONFLUENCE_TOKEN or the CONFLUENCE_USERNAME + CONFLUENCE_PASSWORD pair is required.
Related MCP server: inhouse_confluence_mcp
Usage
npm run build
CONFLUENCE_URL=https://confluence.example.com CONFLUENCE_TOKEN=<pat> node dist/index.jsCLI flags: --version, --help.
Development
npm run build # tsc -> dist/
npm run lint # eslint
npm test # pretest builds, then vitest (unit + stdio smoke test)
npm run check:org # guard: forbidden references, public-registry lockfile, .npmrc pinStatus: Phase 0
The tool registry ships an empty manifest — tools/list returns []. Tool manifests land in
Phase 1+; the provider seam, pagination model, error model and optimistic-lock wrapper are
already in place and tested.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Unofficial Confluence MCP — wraps the Confluence Cloud REST API v2 (OAuth)
Read and write Mission Control state via MCP — projects, tasks, subtasks, templates, status updates.
MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.
One MCP URL for all your connectors — scoped writes, enforced constraints, and a full audit trail.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA read-only MCP server that enables querying and searching Atlassian Confluence pages and Jira issues through their REST APIs. Supports retrieving content by ID or URL, searching using CQL/JQL, and listing spaces and projects.1MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server implementation for interacting with self-hosted Confluence Data Center or Server instances via search, content retrieval, and optional write operations. It features space auto-discovery, audit logging, and granular access control for secure enterprise collaboration.-
- AlicenseBqualityDmaintenanceMCP server for administering Atlassian Confluence Cloud wiki pages, supporting CRUD operations, page navigation, comments, attachments, and more.621GPL 3.0
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Atlassian Confluence through MCP, allowing retrieval of pages by ID and searching with CQL queries.143 npmMIT