{"_id":"mcp-confluence-dc","_rev":"6-c35fb11220b76b46cd92d911227ae474","name":"mcp-confluence-dc","dist-tags":{"latest":"0.47.1"},"versions":{"0.0.0-stage":{"name":"mcp-confluence-dc","version":"0.0.0-stage","_id":"mcp-confluence-dc@0.0.0-stage","stub":true,"maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"dist":{"shasum":"1526139d15ddd07b3859e4dd5dbabd73501d3d1d","tarball":"https://registry.npmjs.org/mcp-confluence-dc/-/mcp-confluence-dc-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-02ef+LFbNB+Y/wgFr9aBUlAwOtg5AUiarIL6douI0vbp+U023099WTaBhrBPcv+axgHKrgwXp4BqFHpJwhbq/w==","signatures":[{"sig":"MEYCIQCnuUXgq4GxFYUkfT2A0CwisM9fz7zZF9ni51At/YXoxAIhAK+ziMlb2l58PSyGXke1Qul8QdoumwbW/kRtsocRsKu5","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":339},"_npmUser":{"name":"aitani","email":"aitani@tekthar.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.44.0":{"name":"mcp-confluence-dc","version":"0.44.0","keywords":["mcp","mcp-server","model-context-protocol","confluence","confluence-data-center","confluence-server","data-center","atlassian","ai","claude"],"license":"MIT","_id":"mcp-confluence-dc@0.44.0","maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"homepage":"https://github.com/tekthar/jira-dc-mcp#readme","bugs":{"url":"https://github.com/tekthar/jira-dc-mcp/issues"},"bin":{"mcp-confluence-dc":"bin/run.js"},"dist":{"shasum":"cfe44ea61eea56630dba3206eab9c16a9b4feba0","tarball":"https://registry.npmjs.org/mcp-confluence-dc/-/mcp-confluence-dc-0.44.0.tgz","fileCount":7,"integrity":"sha512-qiMKBS0BwuBmLzCQMEsSDIKSEBkvhtWh7qDs/cjP/9+TgPqoBJ7LDjxpXr1Nfgt/0ixrNnJWr5rTBfIrw0NS9w==","signatures":[{"sig":"MEUCIQDaaj/CzVh+/kY3UdYCfUwcfKvBUkukB3dVIhwlFqRtVAIgPV4IeHqwD+U+DUTdlbkY8WwvbbWRt5EDBdOynwDbibc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIBKmWss1sUh/N4wKCdg0h9xSGIkzJnxGmoRGd1saf5z5AiA/lRBvJBNIvN4hmwCbnsC2jZCEK6tGhWfRCC7HNnTB6A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":210431},"main":"dist/index.js","type":"module","engines":{"node":">=22.22.2"},"gitHead":"6b2f539fbe7baf70216d8ed6fe5eb5724bf16b14","mcpName":"io.github.tekthar/mcp-confluence-dc","private":false,"scripts":{"dev":"nodemon --exec tsx src/index.ts","test":"jest --passWithNoTests","build":"tsc","start":"node build/index.js","bundle":"node ../../scripts/bundle-server.mjs","inspect":"mcp-inspector node build/index.js","prepack":"tsc --build && npm run bundle","inspect:dev":"mcp-inspector tsx src/index.ts"},"_npmUser":{"name":"aitani","email":"aitani@tekthar.com"},"repository":{"url":"git+https://github.com/tekthar/jira-dc-mcp.git","type":"git","directory":"packages/confluence"},"_npmVersion":"10.9.7","description":"MCP server for Confluence Data Center and Confluence Server: search, read, create and update pages, with page trees, history, labels, comments and attachments. Not affiliated with Atlassian.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"4.6.7","dotenv":"18.0.9","@inquirer/prompts":"7.10.1","@modelcontextprotocol/server":"2.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@atlassian-dc-mcp/common":"0.43.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-confluence-dc_0.44.0_1793950851074_0.3901215123097107","host":"s3://npm-registry-packages-npm-production"}},"0.44.1":{"name":"mcp-confluence-dc","version":"0.44.1","keywords":["mcp","mcp-server","model-context-protocol","confluence","confluence-data-center","confluence-server","data-center","atlassian","ai","claude"],"license":"MIT","_id":"mcp-confluence-dc@0.44.1","maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"homepage":"https://github.com/tekthar/jira-dc-mcp#readme","bugs":{"url":"https://github.com/tekthar/jira-dc-mcp/issues"},"bin":{"mcp-confluence-dc":"bin/run.js"},"dist":{"shasum":"1df56806a4d516315a7decadc6d3c0aeadb56da8","tarball":"https://registry.npmjs.org/mcp-confluence-dc/-/mcp-confluence-dc-0.44.1.tgz","fileCount":7,"integrity":"sha512-wmFtFkex7r9IPv0LeSrQ3s3gik7hwNHYKv1Cw1igxfbJQ/YZXcdOLtjbndMmB2J2HKOxfXLKtO6k7Me5QiAM2Q==","signatures":[{"sig":"MEQCIDUdPjRxXCVA4Cdc2FDU/mEcI44kFQy+IC/73Y0uKsS6AiAzGnax8OwOYnbImBZGSfR54FyL6scP24mP1gJBBhSt7g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDNXiPzvcjzr5FiRrhU8qKw7YcFuF6SfKNNiiy1VXSzbQIhAKbjkw7ukASTDlQahKOGNmeiPm77LfdBpK/HH+uWtjMt","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":210431},"main":"dist/index.js","type":"module","engines":{"node":">=22.22.2"},"gitHead":"64f8abb6dd69704417d425f0e4dbe5a725a813d7","mcpName":"io.github.tekthar/mcp-confluence-dc","private":false,"scripts":{"dev":"nodemon --exec tsx src/index.ts","test":"jest --passWithNoTests","build":"tsc","start":"node build/index.js","bundle":"node ../../scripts/bundle-server.mjs","inspect":"mcp-inspector node build/index.js","prepack":"tsc --build && npm run bundle","inspect:dev":"mcp-inspector tsx src/index.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"9b039b86-0b02-49f5-b59b-6dab0e40c916"}},"repository":{"url":"git+https://github.com/tekthar/jira-dc-mcp.git","type":"git","directory":"packages/confluence"},"_npmVersion":"11.21.1","description":"MCP server for Confluence Data Center and Confluence Server: search, read, create and update pages, with page trees, history, labels, comments and attachments. Not affiliated with Atlassian.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"4.6.7","dotenv":"18.0.9","@inquirer/prompts":"7.10.1","@modelcontextprotocol/server":"2.4.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@atlassian-dc-mcp/common":"0.43.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-confluence-dc_0.44.1_1793952861861_0.8975014234117231","host":"s3://npm-registry-packages-npm-production"}},"0.45.0":{"name":"mcp-confluence-dc","version":"0.45.0","keywords":["mcp","mcp-server","model-context-protocol","confluence","confluence-data-center","confluence-server","data-center","atlassian","ai","claude"],"license":"MIT","_id":"mcp-confluence-dc@0.45.0","maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"homepage":"https://github.com/tekthar/jira-dc-mcp#readme","bugs":{"url":"https://github.com/tekthar/jira-dc-mcp/issues"},"bin":{"mcp-confluence-dc":"bin/run.js"},"dist":{"shasum":"f81728dca7735bfdcbbc8133807e2029b9d71115","tarball":"https://registry.npmjs.org/mcp-confluence-dc/-/mcp-confluence-dc-0.45.0.tgz","fileCount":7,"integrity":"sha512-R3Pn7dx/e98LLj0uoH7LbgU7Q/YwIRGBspBmOVEKhmOQIUZ//7wze78m7lNdsjVBOc9gq4fw2Xn5EnYQC731mQ==","signatures":[{"sig":"MEUCIQDxKvzdkT3NCi42T+st54ZmaxGINdfq+oQ1nPNRaHB4FQIgf09UODtlnQo3krNzmoz1ApUvikK0oQI2PAviPna0qRo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIHqA8lEkx55sDyo/1FCoZmAPhc48+6yu61RqD+F6eZnRAiBb0n5CL4+UAPjKJvGZfjEN6Tz6Xlg/AyLY+PXLZm9ZeA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":233838},"main":"dist/index.js","type":"module","engines":{"node":">=22.22.2"},"gitHead":"aff0e2d3e575bbfd12da2aec96381ce9c6133fa3","mcpName":"io.github.tekthar/mcp-confluence-dc","private":false,"scripts":{"dev":"nodemon --exec tsx src/index.ts","test":"jest --passWithNoTests","build":"tsc","start":"node build/index.js","bundle":"node ../../scripts/bundle-server.mjs","inspect":"mcp-inspector node build/index.js","prepack":"tsc --build && npm run bundle","inspect:dev":"mcp-inspector tsx src/index.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"9b039b86-0b02-49f5-b59b-6dab0e40c916"}},"repository":{"url":"git+https://github.com/tekthar/jira-dc-mcp.git","type":"git","directory":"packages/confluence"},"_npmVersion":"11.21.1","description":"MCP server for Confluence Data Center and Confluence Server: search, read, create and update pages, with page trees, history, labels, comments and attachments. Not affiliated with Atlassian.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"4.6.7","dotenv":"18.0.9","@inquirer/prompts":"7.10.1","quickjs-emscripten-core":"0.32.0","@modelcontextprotocol/server":"2.4.0","@jitl/quickjs-wasmfile-release-sync":"0.32.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@atlassian-dc-mcp/common":"0.43.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-confluence-dc_0.45.0_1793969623939_0.3014768757367562","host":"s3://npm-registry-packages-npm-production"}},"0.47.0":{"name":"mcp-confluence-dc","version":"0.47.0","keywords":["mcp","mcp-server","model-context-protocol","confluence","confluence-data-center","confluence-server","data-center","atlassian","ai","claude"],"license":"MIT","_id":"mcp-confluence-dc@0.47.0","maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"homepage":"https://github.com/tekthar/atlassian-data-center-mcp#readme","bugs":{"url":"https://github.com/tekthar/atlassian-data-center-mcp/issues"},"bin":{"mcp-confluence-dc":"bin/run.js"},"dist":{"shasum":"c29cc0f9d9461620459f965c17d478f880b89f99","tarball":"https://registry.npmjs.org/mcp-confluence-dc/-/mcp-confluence-dc-0.47.0.tgz","fileCount":11,"integrity":"sha512-ROvn9wGlT9DkXKRrja4M/UBRNPNrvlsTIHbXXsb9E9n0x0VB5LfVaS5Nry4m/fbaAnyCCIKpypj+Rq4Qk2wqmA==","signatures":[{"sig":"MEYCIQCugeSSp14oVLpxlTc+ApiKDhwpcDEZjogcK73AoSz4ggIhAMKPJQ+PLtMWhwQ0670rUNgG//OfDuSBBcl3XX41pxF8","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIAk4HgbVaTWhFSUjF7UuiDiBklF23HO9RKkLTnlkr2+5AiEA3hL5HKcsjRoxKUCsy/fkiCpeHHV4EkIyUaC113lkEsQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/mcp-confluence-dc@0.47.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":261270},"main":"dist/index.js","type":"module","engines":{"node":">=22.22.2"},"gitHead":"e6d9d1145fd74c0fd3cf8026246cb965fd50ff9e","mcpName":"io.github.tekthar/mcp-confluence-dc","private":false,"scripts":{"dev":"nodemon --exec tsx src/index.ts","test":"jest --passWithNoTests","build":"tsc","start":"node build/index.js","bundle":"node ../../scripts/bundle-server.mjs","inspect":"mcp-inspector node build/index.js","prepack":"tsc --build && npm run bundle","inspect:dev":"mcp-inspector tsx src/index.ts"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"64324ce7-e3b3-4f70-8930-37ca36717012"}},"repository":{"url":"git+https://github.com/tekthar/atlassian-data-center-mcp.git","type":"git","directory":"packages/confluence"},"_npmVersion":"11.21.1","description":"MCP server for Confluence Data Center and Confluence Server: search, read, create and update pages, with page trees, history, labels, comments and attachments. Not affiliated with Atlassian.","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"4.6.7","dotenv":"18.0.9","@napi-rs/keyring":"2.1.2","@inquirer/prompts":"7.10.1","quickjs-emscripten-core":"0.32.0","@modelcontextprotocol/server":"2.4.0","@jitl/quickjs-wasmfile-release-sync":"0.32.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@atlassian-dc-mcp/common":"0.43.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-confluence-dc_0.47.0_1794002659663_0.07181962517017204","host":"s3://npm-registry-packages-npm-production"}},"0.47.1":{"_id":"mcp-confluence-dc@0.47.1","bin":{"mcp-confluence-dc":"bin/run.js"},"bugs":{"url":"https://github.com/tekthar/atlassian-data-center-mcp/issues"},"dist":{"shasum":"d8d128884790ee682834854e48f293ae4be3a128","tarball":"https://registry.npmjs.org/mcp-confluence-dc/-/mcp-confluence-dc-0.47.1.tgz","fileCount":11,"integrity":"sha512-FA3U7GbS2yb1JcKSBnZTf5zgBlzxxk/bTiXEldkThEMrG/iEfWvPKg22aC21I+q0sJR+235Y2DAhsQgLMXx9mw==","signatures":[{"sig":"MEUCIFQK0ZMHUJgOY/stI0DtayMhbLsryw2a9Wt2d92IA23+AiEAw6/YkMeWeHj/jlRbj6Ls/sdtG0hlp1UfF2OmDeODtno=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCID51ASrYyZR12NGZ8MFcVyf8Qn+oS9ImKlexjdCh3yUJAiAF06DA20qAWk8nhGOfKXneLvB52VTevD6tV2idltA1sg=="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/mcp-confluence-dc@0.47.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":262048},"main":"dist/index.js","name":"mcp-confluence-dc","type":"module","engines":{"node":">=22.22.2"},"gitHead":"027433c1b737a9e56733e29303e5bf7f4bbe2d03","license":"MIT","mcpName":"io.github.tekthar/mcp-confluence-dc","private":false,"scripts":{"dev":"nodemon --exec tsx src/index.ts","test":"jest --passWithNoTests","build":"tsc","start":"node build/index.js","bundle":"node ../../scripts/bundle-server.mjs","inspect":"mcp-inspector node build/index.js","prepack":"tsc --build && npm run bundle","inspect:dev":"mcp-inspector tsx src/index.ts"},"version":"0.47.1","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"64324ce7-e3b3-4f70-8930-37ca36717012"}},"homepage":"https://github.com/tekthar/atlassian-data-center-mcp#readme","keywords":["mcp","mcp-server","model-context-protocol","confluence","confluence-data-center","confluence-server","data-center","atlassian","ai","claude"],"repository":{"url":"git+https://github.com/tekthar/atlassian-data-center-mcp.git","type":"git","directory":"packages/confluence"},"_npmVersion":"11.21.1","description":"MCP server for Confluence Data Center and Confluence Server: search, read, create and update pages, with page trees, history, labels, comments and attachments. Not affiliated with Atlassian.","directories":{},"maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"_nodeVersion":"22.22.2","dependencies":{"zod":"4.6.7","dotenv":"18.0.9","@napi-rs/keyring":"2.1.2","@inquirer/prompts":"7.10.1","quickjs-emscripten-core":"0.32.0","@modelcontextprotocol/server":"2.4.0","@jitl/quickjs-wasmfile-release-sync":"0.32.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@atlassian-dc-mcp/common":"0.43.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-confluence-dc_0.47.1_1794004777661_0.9985285232401513"}}},"time":{"created":"2026-11-06T07:39:13.350Z","modified":"2026-11-06T22:39:38.111Z","0.0.0-stage":"2026-11-06T07:39:13.350Z","0.44.0":"2026-11-06T07:40:51.164Z","0.44.1":"2026-11-06T08:14:21.971Z","0.45.0":"2026-11-06T12:53:44.033Z","0.47.0":"2026-11-06T22:04:19.786Z","0.47.1":"2026-11-06T22:39:37.783Z"},"bugs":{"url":"https://github.com/tekthar/atlassian-data-center-mcp/issues"},"license":"MIT","homepage":"https://github.com/tekthar/atlassian-data-center-mcp#readme","keywords":["mcp","mcp-server","model-context-protocol","confluence","confluence-data-center","confluence-server","data-center","atlassian","ai","claude"],"repository":{"url":"git+https://github.com/tekthar/atlassian-data-center-mcp.git","type":"git","directory":"packages/confluence"},"description":"MCP server for Confluence Data Center and Confluence Server: search, read, create and update pages, with page trees, history, labels, comments and attachments. Not affiliated with Atlassian.","maintainers":[{"name":"aitani","email":"aitani@tekthar.com"}],"readme":"# mcp-confluence-dc\n\n**Connect Claude, Cursor and any other MCP client to Confluence Data Center and Confluence Server, signed in as you.**\n\nThe server runs on your machine. Your MCP client starts it and talks to it over stdio; it calls Confluence's REST API\nwith your personal access token, lists the everyday page tools, and keeps 17 more one search away. Confluence's own\npermissions decide what you can do: the server can hide tools, never unlock them.\n\n```bash\nnpx -y mcp-confluence-dc setup                          # saves your Confluence address and token\nclaude mcp add confluence -- npx -y mcp-confluence-dc   # connects Claude Code\n```\n\n> Not affiliated with or endorsed by Atlassian. Confluence is a trademark of Atlassian.\n\n## Why run it on your machine?\n\n| | A hosted MCP connector | **mcp-confluence-dc** |\n|---|---|---|\n| Works with Confluence Data Center and Server | depends on the service | **yes** |\n| Reaches a Confluence behind your firewall or VPN | only if Confluence is exposed to the service | **yes**: wherever your machine can reach |\n| Where your token lives | with the service | **on your machine**: your OS keychain, or a file only your user can read |\n| Who decides which tools the agent sees | the service | **you**, with a few settings |\n| Something to host, approve or pay for | the service | **nothing**: `npx` runs it |\n\n[Atlassian's official MCP server](https://github.com/atlassian/atlassian-mcp-server) is a hosted server for Atlassian\nCloud.\n\n## Install\n\nYou need Node.js 22.22.2 or later, Confluence Data Center or Confluence Server, and a personal access token. To create\none, open your profile picture in Confluence, then **Settings** > **Personal Access Tokens** > **Create token**.\n\n**1. Save your address and token.** `setup` asks for them, checks them with one request to Confluence, and saves them:\n\n```bash\nnpx -y mcp-confluence-dc setup\n```\n\nThe token goes to your OS keychain: the macOS Keychain, Windows Credential Manager, or on Linux the desktop\nkeyring (GNOME Keyring or KWallet). Everything else goes to `~/.atlassian-dc-mcp/confluence.env`\n(`%USERPROFILE%\\.atlassian-dc-mcp\\confluence.env` on Windows), which only your user can read. Without a keychain, such as\non a Linux server, the token goes in that file too.\n\n**2. Connect your client.** `install` registers the server with Claude Code or Claude Desktop for you:\n\n```bash\nnpx -y mcp-confluence-dc install --claude-code      # runs claude mcp add\nnpx -y mcp-confluence-dc install --claude-desktop   # edits Claude Desktop's config, after backing it up\n```\n\nCursor, VS Code and other clients with an `mcpServers` file:\n\n```json\n{\n  \"mcpServers\": {\n    \"confluence\": { \"command\": \"npx\", \"args\": [\"-y\", \"mcp-confluence-dc\"] }\n  }\n}\n```\n\nTo skip `setup`, put the settings in that entry instead:\n`\"env\": { \"CONFLUENCE_HOST\": \"confluence.example.com\", \"CONFLUENCE_API_TOKEN\": \"<personal access token>\" }`.\n\n## Commands\n\n| Command | Does |\n|---|---|\n| `npx -y mcp-confluence-dc` | Serves Confluence over stdio. This is what your MCP client runs. |\n| `npx -y mcp-confluence-dc setup` | Asks for your address and token, checks them against Confluence, and saves them. |\n| `setup --non-interactive --host <host> --token <token>` | The same from flags, for scripts and CI. Exits non-zero if the token doesn't work. Values you leave out come from your existing settings. |\n| `setup --help` | Lists every option. |\n| `npx -y mcp-confluence-dc install --claude-code [--scope user\\|project\\|local]` | Registers the server with Claude Code by running `claude mcp add`. |\n| `npx -y mcp-confluence-dc install --claude-desktop` | Adds the server to Claude Desktop's configuration, after backing it up. |\n| `npx -y mcp-confluence-dc doctor` | Checks Node.js, where each setting comes from, the keychain, signing in, and the tools your client will see, and says how to fix what's wrong. The token is masked. |\n\n## What the agent sees\n\nThe tool list holds the everyday tools for pages, spaces and attachments, plus four more:\n\n| Tool | What it's for |\n|---|---|\n| `confluence_searchTools` | Finds any other tool by keyword, such as \"page history\" or \"labels\", and returns its description and input schema. Its own description names every toolset it can reach. |\n| `confluence_runReadTool` | Runs a found tool that only reads Confluence. |\n| `confluence_runWriteTool` | Runs a found tool that changes Confluence. Your client can ask you first, as for any write. |\n| `confluence_runCode` | Runs a short JavaScript snippet that combines several read calls and returns only the answer. |\n\nFor a question that takes many calls, `confluence_runCode` keeps the intermediate results out of the context:\n\n```js\nconst found = await tools.confluence_searchContent({ cql: 'space = OPS and label = runbook', limit: 50 });\nconsole.log(`found ${found.results.length} runbooks`);\nreturn found.results.map((result) => result.title);\n```\n\nThe snippet runs in QuickJS, a JavaScript engine compiled to WebAssembly, in its own worker thread. It sees only\n`tools`, `callTool` and `console`: no network, files, processes or timers. It can call read tools only, and stops after\n30 seconds or 50 tool calls (4 at a time), at 64 MB of memory, or with a result over 100,000 characters. If it crashes\nthe engine, only that run fails.\n\n## Toolsets\n\n**On** toolsets are listed directly. **Gateway** toolsets are reached through `confluence_searchTools`.\n\n| Toolset | Default | Tools |\n|---|---|---|\n| `confluence_pages`: search, read, create and update pages | on | `confluence_getContent`, `confluence_searchContent`, `confluence_createContent`, `confluence_updateContent` |\n| `confluence_spaces`: search spaces | on | `confluence_searchSpace` |\n| `confluence_attachments`: download and upload page attachments | on | `confluence_downloadAttachment`, `confluence_uploadAttachment` (opt-in) |\n| `confluence_page_tree`: child pages and a space's page hierarchy | gateway | `confluence_getPageChildren`, `confluence_getSpacePageTree` |\n| `confluence_page_admin`: move, copy and delete (trash) pages | gateway | `confluence_deletePage` (destructive), `confluence_movePage`, `confluence_copyPage` |\n| `confluence_history`: past page versions and a diff of two versions | gateway | `confluence_getPageHistory`, `confluence_getPageDiff` |\n| `confluence_labels`: read and add content labels | gateway | `confluence_getLabels`, `confluence_addLabel` |\n| `confluence_restrictions`: read and set page view and edit restrictions | gateway | `confluence_getPageRestrictions`, `confluence_setPageRestrictions` |\n| `confluence_comments`: read, add and reply to page and inline comments | gateway | `confluence_getComments`, `confluence_getInlineComments`, `confluence_addComment`, `confluence_replyToComment`, `confluence_addInlineComment` |\n| `confluence_attachment_management`: list attachment details and delete attachments | gateway | `confluence_getAttachments`, `confluence_deleteAttachment` (destructive) |\n| `confluence_users`: search users by name or username | gateway | `confluence_searchUser` |\n\nThe tool search never offers a destructive tool. To use one, turn on its toolset with `TOOLSETS`. Page bodies are read\nand written in Confluence storage format (XHTML).\n\n## Supported apps\n\nNo Confluence apps (Marketplace plugins) are supported yet. The Jira server, `mcp-jira-dc`, has tools for Xray and Jira\nService Management; [Supported apps](https://github.com/tekthar/atlassian-data-center-mcp/blob/main/docs/supported-apps.md) lists them with the versions they were built from.\n\n## Settings\n\nEvery setting is an environment variable. Each comes from the first of these that has it: the environment, the dotenv\nfile named by `ATLASSIAN_DC_MCP_CONFIG_FILE`, the file `setup` writes, then the OS\nkeychain.\n\n**Connecting**\n\n| Variable | Use |\n|---|---|\n| `CONFLUENCE_HOST` | Host name and optional port, without `https://`, e.g. `confluence.example.com`. |\n| `CONFLUENCE_API_BASE_PATH` | Full REST API URL, used instead of `CONFLUENCE_HOST`, e.g. `https://example.com/wiki/rest/api`. |\n| `CONFLUENCE_API_TOKEN` | Personal access token. |\n| `CONFLUENCE_DEFAULT_PAGE_SIZE` | Page size for search and list tools. Default 25. |\n| `ATLASSIAN_DC_MCP_CONFIG_FILE` | Absolute path to a dotenv file with any of these settings, e.g. one file shared by several servers. |\n| `ATLASSIAN_DC_MCP_REQUEST_TIMEOUT_MS` | How long a request to Confluence may take. Default 30000. |\n| `ATLASSIAN_DC_MCP_KEYCHAIN` | `off` keeps the token out of the OS keychain: `setup` saves it in the file instead, and the server doesn't look in the keychain. |\n\n**Choosing tools**\n\n| Variable | Use |\n|---|---|\n| `TOOLSETS` | Toolsets to list directly: names, `default`, or `all`, e.g. `default,confluence_page_tree`. |\n| `READ_ONLY_MODE` | `true` offers only tools that never change Confluence. |\n| `ENABLED_TOOLS` | An exact list of tool names. Replaces `TOOLSETS`, and turns the tool search and `confluence_runCode` off. |\n| `TOOL_GATEWAY` | `off` turns the tool search off: tools outside the selected toolsets are left out. |\n| `CODE_EXECUTION` | `off` removes `confluence_runCode`. |\n\n**Attachments on disk**\n\n| Variable | Use |\n|---|---|\n| `CONFLUENCE_ATTACHMENTS_UPLOAD_ENABLED`, `CONFLUENCE_ATTACHMENTS_DOWNLOAD_ENABLED` | `true` lets attachments be uploaded from, or saved to, your disk. Default off: downloads come back inline and never touch the disk. |\n| `CONFLUENCE_ATTACHMENTS_UPLOAD_ROOTS`, `CONFLUENCE_ATTACHMENTS_DOWNLOAD_ROOTS` | Folders allowed for each direction, separated like your OS `PATH`. |\n| `CONFLUENCE_ATTACHMENTS_DIR` | One folder used for both directions. |\n| `CONFLUENCE_ATTACHMENTS_MAX_UPLOAD_BYTES`, `CONFLUENCE_ATTACHMENTS_MAX_DOWNLOAD_BYTES` | Size limits. Default 25 MiB. |\n\n**Audit log**\n\n| Variable | Use |\n|---|---|\n| `ATLASSIAN_DC_MCP_AUDIT` | `1` writes one JSON line per tool call: the time, server, tool, outcome and duration, never the arguments or results. A tool run through the tool search or from `confluence_runCode` is recorded too, with `\"via\"`. |\n| `ATLASSIAN_DC_MCP_AUDIT_FILE` | Where to write it. Default `~/.atlassian-dc-mcp/audit/mcp-confluence-dc.jsonl` (mode 0600 on macOS and Linux). It rotates at 5 MB, keeping three old files. |\n\n## What it guarantees\n\n- **It never widens access.** Every request carries your token, so Confluence decides what you can do. Hiding a tool\n  trims what the agent sees; it never unlocks anything.\n- **Writes stay visible.** Every tool tells your client whether it reads, changes or deletes, so the client can ask you\n  first. `confluence_runCode` can only call read tools.\n- **Deleting is always your decision.** Delete tools appear only in toolsets you turn on, never through the tool search\n  or `confluence_runCode`.\n- **It never retries a call on its own.** If a request fails, the agent sees Confluence's error and decides what to do.\n- **It stays out of your files.** Attachments are read from and saved to only the folders you name, and a saved file\n  never overwrites an existing one.\n\nPages, comments and attachments are written by other people, so treat them as data, not instructions.\n`confluence_downloadAttachment` shows an image to the model only when asked to, with `returnContent: 'image'`.\n\n## Related projects\n\n- [mcp-jira-dc](https://www.npmjs.com/package/mcp-jira-dc) and\n  [mcp-bitbucket-dc](https://www.npmjs.com/package/mcp-bitbucket-dc): the same approach for Jira and Bitbucket Data\n  Center.\n- [sooperset/mcp-atlassian](https://github.com/sooperset/mcp-atlassian): a Python server for Jira and Confluence, Cloud\n  and Data Center.\n\n## Acknowledgments\n\nmcp-confluence-dc builds on two MIT-licensed projects: [b1ff/atlassian-dc-mcp](https://github.com/b1ff/atlassian-dc-mcp),\nand [sooperset/mcp-atlassian](https://github.com/sooperset/mcp-atlassian), whose Data Center tools were adapted for this\nserver. Their copyright notices are in [LICENSE](LICENSE).\n\n## License\n\nMIT. Part of [Atlassian Data Center MCP](https://github.com/tekthar/atlassian-data-center-mcp), with\n[mcp-jira-dc](https://www.npmjs.com/package/mcp-jira-dc) and\n[mcp-bitbucket-dc](https://www.npmjs.com/package/mcp-bitbucket-dc).\n","readmeFilename":"README.md"}