@colinnian/mcp-server-atlassian-confluence

MCP (Model Context Protocol) server for Confluence Server (self-hosted). Enables AI assistants (Claude, Cursor AI, etc.) to read and write Confluence pages.

Based on @shopee/mcp-server-atlassian-confluence, with added write support (create_page, update_page) and adapted for self-hosted Confluence Server (e.g., confluence.shopee.io).

Features

| Tool | Description | Type | |------|-------------|------| | list_pages | List/filter pages by space, status, query | Read | | get_page | Get full page content and metadata | Read | | search | Search using CQL (Confluence Query Language) | Read | | create_page | Create a new page in a space | Write | | update_page | Update an existing page (auto version increment) | Write |

Quick Start

1. Get Your API Token

Go to your Confluence instance and generate a Personal Access Token (PAT), or use your existing Bearer token.

2. Configure in Cursor / Claude Desktop

Add to your MCP config (e.g., ~/.cursor/mcp.json):

{
  "mcpServers": {
    "confluence": {
      "command": "npx",
      "args": ["-y", "@colinnian/mcp-server-atlassian-confluence"],
      "env": {
        "API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Or install globally:

npm install -g @colinnian/mcp-server-atlassian-confluence

Then configure:

{
  "mcpServers": {
    "confluence": {
      "command": "mcp-atlassian-confluence",
      "env": {
        "API_TOKEN": "your_api_token_here"
      }
    }
  }
}

3. Restart your AI assistant

After configuration, restart Cursor or Claude Desktop. The confluence tools will be available.

Tool Usage Examples

create_page

{
  "spaceKey": "DEV",
  "title": "My New Page",
  "body": "<p>Hello World</p>",
  "parentId": "123456"
}

• spaceKey (required): The space key (e.g., "DEV", "TEAM")
• title (required): Page title
• body (required): Content in Confluence storage format (XHTML)
• parentId (optional): Parent page ID for creating child pages

update_page

{
  "pageId": "789012",
  "title": "Updated Title",
  "body": "<h1>New Content</h1><p>Updated via MCP</p>"
}

• pageId (required): The page ID to update
• title (required): New page title
• body (required): New content in storage format
• version (optional): Version number (auto-incremented if omitted)

search

{
  "cql": "text ~ 'API documentation' AND space = DEV",
  "limit": 10
}

Adapting to Other Confluence Instances

This package is pre-configured for confluence.shopee.io. To use with a different Confluence Server instance, edit dist/utils/transport.util.js and change the baseUrl:

const baseUrl = `https://your-confluence.example.com`;

License

ISC