confluence-server-mcp

Confluence MCP Server (confluence-server-mcp)

A Model Context Protocol (MCP) server that exposes the Confluence Server / Data Center REST API to MCP clients (Claude Desktop, Cursor, etc.).

It authenticates with a Personal Access Token (PAT) using the Authorization: Bearer header.

Install

npm install -g confluence-server-mcp

Or run it directly via npx:

npx confluence-server-mcp

Features

Read and write access to Confluence via these tools:

Tool	Description
list_spaces	List spaces (optionally filter by global / personal)
get_space	Get a single space by key
get_page	Fetch a page by ID (body, version, space, ancestors, labels)
search	Search content with CQL
create_page	Create a page in a space (optional parent)
update_page	Update a page title/body (creates a new version)
add_labels	Add labels to a page
list_labels	List labels on a page
list_attachments	List attachments on a page

Requirements

• Node.js >= 18
• A Confluence Server/Data Center instance (version 7.9+ for PAT support)
• A Personal Access Token (create it in your Atlassian profile: Profile → Personal Access Tokens)

Setup (from source)

npm install
npm run build

Configuration

The server reads configuration from environment variables:

Variable	Required	Default	Description
CONFLUENCE_URL	Yes	—	Base URL (no trailing slash)
CONFLUENCE_TOKEN	Yes	—	Personal Access Token
CONFLUENCE_PAGE_SIZE	No	25	Page size for list/search tools

You can create a .env file and load it with your MCP client, or export the variables directly.

Note: the SDK does not auto-load .env. Pass env vars explicitly (see below), or use a tool like dotenv-cli / direnv / your MCP client's env block.

Running

npm run start          # from source
confluence-server-mcp  # global install (bin name)

MCP Client Configuration

Add this to your MCP client config. Example for Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "confluence": {
      "command": "npx",
      "args": ["-y", "confluence-server-mcp"],
      "env": {
        "CONFLUENCE_URL": "https://confluence.example.com",
        "CONFLUENCE_TOKEN": "your-personal-access-token"
      }
    }
  }
}

For Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "confluence": {
      "command": "npx",
      "args": ["-y", "confluence-server-mcp"],
      "env": {
        "CONFLUENCE_URL": "https://confluence.example.com",
        "CONFLUENCE_TOKEN": "your-personal-access-token"
      }
    }
  }
}

Example tool calls

Search for pages mentioning "roadmap" in a space:

search: { "cql": "space = \"MYSPACE\" AND text ~ \"roadmap\"", "limit": 10 }

Get a page body:

get_page: { "pageId": "123456789" }

Create a page:

create_page: { "spaceKey": "MYSPACE", "title": "New page", "body": "<p>Hello <strong>world</strong></p>" }

Development

npm run dev      # run with tsx (hot reload)
npm run typecheck
npm run build

Security

• Never commit your token. It is provided only via the CONFLUENCE_TOKEN environment variable.
• The token is used exclusively in the Authorization: Bearer header for REST API calls.