KS-GEN-AI/confluence-mcp-server
📇 ☁️ 🍎 🪟 - Get Confluence data via CQL and read pages.
Quick Install
{
"mcpServers": {
"ks-gen-ai-confluence-mcp-server": {
"command": "npx",
"args": [
"-y",
"ks-gen-ai-confluence-mcp-server"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
Confluence Communication Server MCP Server
Interact with Confluence
This is a TypeScript-based MCP server that provides tools to interact with Confluence. It demonstrates core MCP concepts by providing:
- Tools for executing CQL queries to search pages
- Tools for retrieving the content of Confluence pages
- Tools for updating content on Confluence pages
Features
Confluence Tools
execute_cql_search
- Purpose: Run a CQL query to search for Confluence pages.
- Parameters:
cql,limit(default: 10).
get_page_content
- Purpose: Fetch the content of a Confluence page.
- Parameters:
pageId.
update_page_content
- Purpose: Update the content of a Confluence page.
- Parameters:
pageId,content,title(optional, if you want to change it).
Development
Install dependencies:
npm install
Build the server:
npm run build
For development with auto-rebuild:
npm run watch
Installation
Installing via Smithery
To install Confluence Communication Server MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @KS-GEN-AI/confluence-mcp-server --client claude
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"Confluence communication server": {
"command": "node",
"args": ["/PATH_TO_THE_PROJECT/build/index.js"],
"env": {
"CONFLUENCE_URL": "https://XXXXXXXX.atlassian.net/wiki",
"CONFLUENCE_API_MAIL": "Your email",
"CONFLUENCE_API_KEY": "KEY_FROM: https://id.atlassian.com/manage-profile/security/api-tokens"
}
}
}
}
Debugging
Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:
npm run inspector
The Inspector will provide a URL to access debugging tools in your browser.