search_confluenceLABSCO SUMMARY
Your wiki, readable and writable, one space list at a time.
The allow-list is the part worth noticing. You decide up front which spaces are in scope, so a write tool pointed at a company-wide wiki has a blast radius you chose rather than one you inherited.
What it is
An MCP server over the Confluence REST API. It searches, reads, creates, updates and deletes pages, lists spaces and their contents, and confines everything to the space keys you list in its configuration.
What you get
- Confluence searched across the spaces you have allowed
- A page read by ID
- A page created in a space, updated, or deleted
- Every space listed, and one space's contents
- Access confined to a comma-separated allow-list of space keys
Requirements
A Confluence base URL, your account email and an API token, plus the list of space keys it may touch — all set in the environment. The project builds locally with npm run build; there is no published package.
Setup effort
Build from source — git clone https://github.com/Olson3R/confluence-mcp.git
USE CASES
01
Finding the runbook nobody remembers the title of
Search across the allowed spaces, then open the page the hit points to.
02
Writing up a decision while it is still fresh
Create the page in the right space straight from the conversation that produced it.
03
Keeping a page current after a change ships
Read the page as it stands, then write the revision back.
04
Taking stock of what a space actually contains
List the spaces you can reach, then read the contents of the one you are auditing.
05
Clearing out a page that should not exist
Delete it directly, inside the space list you defined.
7 tools
Listed in project docs. Your client may show a different list.
get_pagecreate_pageupdate_pagedelete_pagelist_spacesget_space_contentBEFORE YOU INSTALL
What to know first
Tools you get
7 tools named in the project's documentation.
Requires
- Node.js and npm, to build from the clone
- CONFLUENCE_BASE_URL, CONFLUENCE_USERNAME, CONFLUENCE_API_TOKEN and ALLOWED_SPACES in the client configuration
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/Olson3R/confluence-mcp.git
cd confluence-mcp
npm install
npm run buildMCP Clients
Claude Code — add-json
After the build step, run this in a terminal — claude mcp add-json takes the JSON as its second argument, in single quotes:
CLAUDE CODE — ADD-JSON · TERMINAL
claude mcp add-json confluence '{"command":"node","args":["<YOUR_PATH_TO_CONFLUENCE_MCP>/dist/index.js"],"env":{"CONFLUENCE_BASE_URL":"https://<YOUR_DOMAIN>.atlassian.net","CONFLUENCE_USERNAME":"<YOUR_CONFLUENCE_USERNAME>","CONFLUENCE_API_TOKEN":"<YOUR_CONFLUENCE_API_TOKEN>","ALLOWED_SPACES":"SPACE1,SPACE2,SPACE3"}}'<YOUR_PATH_TO_CONFLUENCE_MCP> is the full path of the confluence-mcp folder the clone step creates. <YOUR_DOMAIN> is your Atlassian site, <YOUR_CONFLUENCE_USERNAME> your account email and <YOUR_CONFLUENCE_API_TOKEN> an API token (id.atlassian.com > Security > API tokens); ALLOWED_SPACES lists the space keys it may reach.
Claude Code — Manual config
CLAUDE CODE — MANUAL CONFIG · JSON
{
"mcpServers": {
"confluence": {
"command": "node",
"args": [
"<YOUR_PATH_TO_CONFLUENCE_MCP>/dist/index.js"
],
"env": {
"CONFLUENCE_BASE_URL": "https://<YOUR_DOMAIN>.atlassian.net",
"CONFLUENCE_USERNAME": "<YOUR_CONFLUENCE_USERNAME>",
"CONFLUENCE_API_TOKEN": "<YOUR_CONFLUENCE_API_TOKEN>",
"ALLOWED_SPACES": "SPACE1,SPACE2,SPACE3"
}
}
}
}<YOUR_PATH_TO_CONFLUENCE_MCP> is the full path of the confluence-mcp folder the clone step creates. <YOUR_DOMAIN> is your Atlassian site, <YOUR_CONFLUENCE_USERNAME> your account email and <YOUR_CONFLUENCE_API_TOKEN> an API token (id.atlassian.com > Security > API tokens); ALLOWED_SPACES lists the space keys it may reach. Restart Claude Code afterwards.
Claude Code — tsx
CLAUDE CODE — TSX · JSON
{
"mcpServers": {
"confluence-mcp": {
"command": "npx",
"args": [
"tsx",
"<YOUR_PATH_TO_CONFLUENCE_MCP>/src/index.ts"
],
"env": {
"CONFLUENCE_BASE_URL": "https://<YOUR_DOMAIN>.atlassian.net",
"CONFLUENCE_USERNAME": "<YOUR_CONFLUENCE_USERNAME>",
"CONFLUENCE_API_TOKEN": "<YOUR_CONFLUENCE_API_TOKEN>",
"ALLOWED_SPACES": "SPACE1,SPACE2,SPACE3"
}
}
}
}<YOUR_PATH_TO_CONFLUENCE_MCP> is the full path of the confluence-mcp folder the clone step creates. <YOUR_DOMAIN> is your Atlassian site, <YOUR_CONFLUENCE_USERNAME> your account email and <YOUR_CONFLUENCE_API_TOKEN> an API token (id.atlassian.com > Security > API tokens); ALLOWED_SPACES lists the space keys it may reach.
