confluence_test_connectionLABSCO SUMMARY
Safe by default, wide once you open it.
Two switches decide what an agent can do on your wiki: writes are off until CONFLUENCE_READ_ONLY is false, and deletes and permission changes stay off after that until enabled separately. There is also a tool allowlist and a space allowlist if on/off is too coarse. Worth setting deliberately, because a confused agent can do a lot of quiet damage to a wiki.
What it is
An MCP server for Confluence that talks to Cloud, on-premise Server and Data Center from one package. It goes well past reading pages: spaces get created and deleted, pages get copied and moved, restrictions get set, inline tasks get extracted, export URLs get generated. It ships read-only and you opt into writes.
What you get
- Page work — read, create, update, patch, append, replace a range, copy, move and delete —
confluence_get_page,confluence_create_page,confluence_update_page,confluence_patch_page,confluence_append_to_page,confluence_replace_page_range,confluence_copy_page,confluence_move_page,confluence_delete_page - Finding pages: full CQL and text search, lookup by title or by a pasted Confluence URL, and recently modified —
confluence_search,confluence_search_pages,confluence_get_page_by_title,confluence_get_page_by_url,confluence_get_recently_modified - Long pages read in pieces rather than all at once —
confluence_get_page_body_chunk - Spaces: list, inspect, find the homepage, create — including a private one — and delete —
confluence_get_spaces,confluence_get_space_by_key,confluence_get_space_homepage,confluence_create_space,confluence_create_private_space,confluence_delete_space - Hierarchy and history: children, ancestors, the version list and one version's content —
confluence_get_child_pages,confluence_get_page_ancestors,confluence_get_page_versions,confluence_get_page_version - Labels, comments and attachments, including uploading a file from the host —
confluence_add_page_label,confluence_delete_page_label,confluence_get_page_comments,confluence_add_page_comment,confluence_get_page_attachments,confluence_upload_attachment - Watchers, restrictions and inline tasks, plus PDF and Word export URLs —
confluence_get_page_watchers,confluence_watch_page,confluence_unwatch_page,confluence_get_page_permissions,confluence_set_page_permissions,confluence_get_page_tasks,confluence_export_page
Requirements
Node.js 20 or newer and a Confluence instance — Cloud, or Server/Data Center 7.9+. npx atlassian-confluence-mcp-server runs it with nothing installed (1.6.0 in package.json). Credentials come from the environment: CONFLUENCE_BASE_URL always, then PAT alone for Server and Data Center, or CONFLUENCE_USERNAME plus PAT for Cloud, with CONFLUENCE_PASSWORD as the Basic Auth fallback. CONFLUENCE_READ_ONLY defaults to true, so mutating tools stay off until you set it to false, and CONFLUENCE_ENABLE_DESTRUCTIVE_TOOLS defaults to false, gating deletes and permission changes separately. Attachment uploads stay disabled until CONFLUENCE_UPLOAD_ALLOWED_DIRS names the directories they may read from.
Setup effort
One command plus a key — npx atlassian-confluence-mcp-server, then supply credentials
USE CASES
Answering from the team wiki
Search with CQL, then read the page — long ones come back in chunks rather than one wall of text.
Turning a conversation into a page
Create the page in the right space, then attach a label and a comment.
Reorganizing a space
Copy or move pages, then walk the parent and child tree to confirm where they landed.
Finding out what changed
List a page's versions and read one of them to compare against what is live.
Collecting the action items
Extract the inline tasks from a meeting page instead of reading the whole thing.
47 tools
Listed in project docs. Your client may show a different list.
confluence_get_spacesconfluence_get_spaceconfluence_get_space_by_keyconfluence_create_spaceconfluence_delete_spaceconfluence_get_space_homepageconfluence_get_pagesconfluence_get_pageconfluence_get_page_by_titleconfluence_create_pageconfluence_update_pageconfluence_patch_pageconfluence_replace_page_rangeconfluence_append_to_pageconfluence_get_page_body_chunkconfluence_delete_pageconfluence_copy_pageconfluence_move_pageconfluence_searchconfluence_search_pagesconfluence_get_recently_modifiedconfluence_get_page_labelsconfluence_add_page_labelconfluence_delete_page_labelconfluence_get_page_commentsconfluence_add_page_commentconfluence_get_page_attachmentsconfluence_get_comment_attachmentsconfluence_upload_attachmentconfluence_get_child_pagesconfluence_get_page_ancestorsconfluence_get_page_versionsconfluence_get_page_versionconfluence_get_page_propertiesconfluence_get_current_userconfluence_get_page_watchersconfluence_watch_pageconfluence_unwatch_pageconfluence_get_page_permissionsconfluence_set_page_permissionsconfluence_get_page_tasksconfluence_export_pageconfluence_get_page_by_urlconfluence_get_personal_space_keyconfluence_create_page_in_personal_spaceconfluence_create_private_spaceBEFORE YOU INSTALL
What to know first
Tools you get
47 tools named in the project's documentation.
Requires
- npx on PATH
- Node.js 20+
- CONFLUENCE_BASE_URL in your environment
- PAT in your environment
- CONFLUENCE_USERNAME in your environment (Confluence Cloud only)
INSTALLATION
Connect your client
Server setup
npx atlassian-confluence-mcp-serverMCP Clients
Any MCP client — Confluence Cloud
{
"mcpServers": {
"confluence": {
"command": "npx",
"args": [
"-y",
"atlassian-confluence-mcp-server"
],
"env": {
"CONFLUENCE_BASE_URL": "https://<YOUR_SITE>.atlassian.net",
"CONFLUENCE_USERNAME": "<YOUR_CONFLUENCE_USERNAME>",
"PAT": "<YOUR_PAT>"
}
}
}
}Any MCP client — Data Center
{
"mcpServers": {
"confluence": {
"command": "npx",
"args": [
"-y",
"atlassian-confluence-mcp-server"
],
"env": {
"CONFLUENCE_BASE_URL": "<YOUR_CONFLUENCE_BASE_URL>",
"PAT": "<YOUR_PAT>"
}
}
}
}Any MCP client — global install
Install it globally
npm install -g atlassian-confluence-mcp-serverAdd the server to your client
{
"mcpServers": {
"confluence": {
"command": "atlassian-confluence-mcp-server",
"env": {
"CONFLUENCE_BASE_URL": "<YOUR_CONFLUENCE_BASE_URL>",
"PAT": "<YOUR_PAT>"
}
}
}
}Any MCP client — from source
Build from source
git clone https://github.com/anuragagrawal0430/atlassian-confluence-mcp-server.git
cd atlassian-confluence-mcp-server
npm install
npm run buildAdd the server to your client, with the absolute path of the built dist/index.js
{
"mcpServers": {
"confluence": {
"command": "node",
"args": [
"<YOUR_PATH_TO_ATLASSIAN_CONFLUENCE_MCP_SERVER>/dist/index.js"
],
"env": {
"CONFLUENCE_BASE_URL": "<YOUR_CONFLUENCE_BASE_URL>",
"PAT": "<YOUR_PAT>"
}
}
}
}