Confluence Server MCP

A Model Context Protocol (MCP) server that connects AI assistants to Confluence Server/Data Center. Search pages, manage content, handle attachments, and interact with your Confluence instance through natural language in Claude and other AI assistants.

Quick Start

Get Your Confluence Server Credentials

1. Log into your Confluence Server instance
2. Go to Profile > Settings > Personal Access Tokens
3. Click Create token
4. Give it a name and copy the generated token
5. Note your Confluence Server URL (e.g., https://confluence.yourcompany.com)

Configuration

Claude Code

Add the server using the Claude Code CLI:

claude mcp add -s user \
    confluence-server \
    npx mcp-confluence-data-center@latest \
    -e "CONFLUENCE_URL=https://confluence.yourcompany.com" \
    -e "CONFLUENCE_TOKEN=your_personal_access_token"

Manual Configuration (Any MCP Client)

Add this configuration to your MCP client's configuration file:

{
  "mcpServers": {
    "confluence-server": {
      "command": "npx",
      "args": ["mcp-confluence-data-center@latest"],
      "type": "stdio",
      "env": {
        "CONFLUENCE_URL": "https://confluence.yourcompany.com",
        "CONFLUENCE_TOKEN": "your_personal_access_token"
      }
    }
  }
}

Available Tools

The server provides 16 MCP tools for Confluence Server operations. All tools are prefixed with confluence_ to avoid name collisions.

Search (1 tool)

• confluence_search - Search content with CQL (Confluence Query Language)

Pages (6 tools)

• confluence_get_page - Get page content (by ID, or by title + space key; supports historical versions)
• confluence_get_page_children - Get child pages of a page
• confluence_get_page_history - Get version history of a page
• confluence_create_page - Create a new page
• confluence_update_page - Update page content (auto-fetches version if not provided)
• confluence_delete_page - Delete a page

Comments (2 tools)

• confluence_get_comments - Get comments on a page
• confluence_add_comment - Add a comment to a page

Labels (2 tools)

• confluence_get_labels - Get labels on a page
• confluence_add_label - Add labels to a page

Attachments (5 tools)

• confluence_get_attachments - List attachments on a page
• confluence_download_attachment - Download a single attachment
• confluence_download_all_attachments - Download all attachments from a page
• confluence_upload_attachment - Upload files to a page (supports multiple files)
• confluence_delete_attachment - Delete an attachment

Example Queries

• "Search for pages about deployment in the DOCS space"
• "Get the contents of the Architecture Overview page in DOCS"
• "Create a new page under the team space with meeting notes"
• "Update the runbook page with the new procedure"
• "Download all attachments from page 12345"
• "Add the 'reviewed' label to the design document"
• "Show me the version history of the API spec page"

Development

From Source

git clone https://github.com/evrimalacan/mcp-confluence-data-center.git
cd mcp-confluence-data-center
npm install
npm run build
npm run dev

See CLAUDE.md for detailed development guidelines.

Troubleshooting

Common Issues

"Authentication failed"

• Verify your Personal Access Token is correct
• Ensure the token has not expired

"Access forbidden"

• Check your Confluence user has permission for the space or page
• Verify space-level permissions

"Resource not found"

• Confirm the page ID, space key, or attachment ID is correct
• Check you have access to the specified resource

Documentation

• Development Guide - Detailed development and contribution guide
• Confluence Server REST API - Official API reference
• Model Context Protocol - MCP specification

License

MIT License - see LICENSE file for details.