Confluence MCP Server

An MCP Server for reading and analyzing Confluence documentation content. Supports extraction and conversion of text, tables, code blocks, images, and more.

Features

• get_confluence_page — Retrieve the full page content (in Markdown format) for Q&A and analysis

• get_page_structure — Get an overview of the page structure (table of contents, presence of tables/code/images)

• get_child_pages — Get a list of child pages

• get_page_attachments — Get a list of attachments

Related MCP server: Confluence MCP Server

Installation

1. Create a virtual environment and install

cd confluence-mcp
python -m venv .venv

# Windows
.venv\Scripts\activate

# Linux/Mac
source .venv/bin/activate

pip install -e .

2. Configure environment variables

Copy .env.example to .env and edit it:

cp .env.example .env

# Confluence Server 地址（不要尾部斜杠）
CONFLUENCE_BASE_URL=https://confluence.yourcompany.com

# Personal Access Token
# 获取方式: Confluence → 右上角头像 → 设置 → Personal Access Tokens → 创建
CONFLUENCE_PAT=your_token_here

# 内网自签证书时设为 false
CONFLUENCE_VERIFY_SSL=true

3. Test run

# 直接运行看是否正常启动
python -m confluence_mcp.server

# 或使用 mcp dev 工具调试
mcp dev confluence_mcp/server.py

Integration with VS Code / Copilot Chat

Add the following to your VS Code settings.json:

{
  "mcp": {
    "servers": {
      "confluence": {
        "command": "python",
        "args": ["-m", "confluence_mcp.server"],
        "cwd": "C:\\Users\\wang2\\mcp\\confluence-mcp",
        "env": {
          "CONFLUENCE_BASE_URL": "https://confluence.yourcompany.com",
          "CONFLUENCE_PAT": "your_token_here",
          "CONFLUENCE_VERIFY_SSL": "true"
        }
      }
    }
  }
}

You can also omit the env settings in settings.json and let the server read from the .env file instead.

Integration with Claude Desktop

Add the following to claude_desktop_config.json:

{
  "mcpServers": {
    "confluence": {
      "command": "C:\\Users\\wang2\\mcp\\confluence-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "confluence_mcp.server"],
      "cwd": "C:\\Users\\wang2\\mcp\\confluence-mcp",
      "env": {
        "CONFLUENCE_BASE_URL": "https://confluence.yourcompany.com",
        "CONFLUENCE_PAT": "your_token_here"
      }
    }
  }
}

Usage

Once configured, simply ask in Copilot Chat or Claude:

帮我看一下这个文档的内容：https://confluence.yourcompany.com/display/TEAM/Some+Page

这个文档里关于部署流程是怎么写的？

总结一下这个页面：https://confluence.yourcompany.com/pages/viewpage.action?pageId=12345

The LLM will automatically call get_confluence_page to retrieve the content and then answer your questions based on that content.

Regarding Intranet Request Blocking

This tool uses a browser User-Agent and full browser request headers in its HTTP requests to bypass potential non-browser request blocking. If you are still being blocked, you may need to:

1. Whitelist the request source IP

2. Or contact IT to confirm if the REST API requires additional configuration

Supported URL Formats

• https://confluence.example.com/pages/viewpage.action?pageId=12345

• https://confluence.example.com/display/SPACE/Page+Title

• https://confluence.example.com/spaces/SPACE/pages/12345/Page+Title

• https://confluence.example.com/wiki/spaces/SPACE/pages/12345/...