Confluence MCP Server

Available Endpoints

• /api/health - Health check
• /api/mcp - Main MCP endpoint (POST)

Available Tools (32 total)

Space Operations (2 tools)

• get_spaces - Get list of all Confluence spaces
• get_space - Get details of a specific space (spaceKey optional)

Content & Search (3 tools)

• get_content_by_id - Get page content by ID
• get_content_by_space_and_title - Get page by space key and title (spaceKey optional)
• search - Search Confluence content using CQL

Page Management (5 tools)

• create_page - Create a new Confluence page (spaceKey optional)
• update_page - Update an existing page
• get_page_children - Get child pages of a page
• get_page_history - Get version history of page changes
• add_page_labels - Add labels to a page

Document & Attachment Management (6 tools)

• get_page_attachments - Get attachments for a page
• upload_document - Upload document/file as attachment
• update_document - Update existing document attachment
• delete_document - Delete document attachment
• list_documents - List all documents in a space (spaceKey optional)
• embed_existing_attachment - Embed existing attachment in page

Image Upload & Embedding (2 tools)

• upload_and_embed_document - Upload and auto-embed document (supports base64 or blob URL)
• upload_and_embed_attachment - Upload file and embed as image/link in one operation

Folder & Hierarchy (3 tools)

• create_folder - Create folder for organizing docs (spaceKey optional)
• get_folder_contents - Get all child pages within a folder
• move_page_to_folder - Move page to different parent folder

Templates (4 tools)

• create_page_template - Create reusable page template (spaceKey optional)
• get_page_templates - Get all templates in a space (spaceKey optional)
• apply_page_template - Create new page from template (spaceKey optional)
• update_page_template - Update existing page template

Labels & Organization (1 tool)

• get_pages_by_label - Find pages tagged with specific label (spaceKey optional)

Macros (3 tools)

• insert_macro - Insert Confluence macro (status, info, warning, code, etc.)
• update_macro - Update existing macro parameters
• get_page_macros - List all macros on a page

JIRA Integration (2 tools)

• link_page_to_jira_issue - Add link from page to JIRA issue
• insert_jira_macro - Insert JIRA macro with JQL query

Permissions (1 tool)

• get_space_permissions - Get permission settings for a space (spaceKey optional)

Usage Example

Create a page (no spaceKey needed!):

POST /api/mcp
Headers:
  X-API-Key: pk_your_api_key
  Content-Type: application/json

Body:
{
  "tool": "create_page",
  "arguments": {
    "title": "My New Page",
    "content": "<h1>Hello World</h1><p>This page was created without passing spaceKey!</p>"
  }
}

Upload and embed a diagram:

POST /api/mcp
Body:
{
  "tool": "upload_and_embed_document",
  "arguments": {
    "pageId": "264468459847682",
    "file": {
      "name": "diagram.png",
      "data": "base64_encoded_data_here",
      "mimeType": "image/png"
    },
    "width": 800,
    "position": "center"
  }
}

Example Response

{
  "success": true,
  "tool": "search",
  "result": {
    "results": [...],
    "start": 0,
    "limit": 10,
    "size": 10
  }
}

Integration with Project Registry

This Confluence MCP server integrates with the Project Registry to fetch Confluence credentials and configuration automatically:

1. Register your project with Confluence credentials in the Project Registry
2. Configure default spaceKey in the registry (e.g., "SA1")
3. Use the provided API key in the X-API-Key header
4. The server automatically fetches:
   • Confluence base URL
   • Authentication credentials (email + API token)
   • Default spaceKey (no need to pass in API calls!)
5. Confluence operations are executed with your credentials