confluence-mcp

Confluence MCP Server

MCP server for Confluence integration — read, write, search, and manage attachments via the Confluence REST API.

Installation

npm install -g @mcd/confluence-mcp-server

Or use with npx:

npx @mcd/confluence-mcp-server

Configuration

Add to your MCP settings (e.g. ~/.kiro/settings/mcp.json):

{
  "mcpServers": {
    "confluence-mcp": {
      "command": "npx",
      "args": ["@mcd/confluence-mcp-server@latest"],
      "env": {
        "CONFLUENCE_URL": "https://your-confluence.atlassian.net",
        "CONFLUENCE_USERNAME": "your-email@example.com",
        "CONFLUENCE_TOKEN": "your-api-token",
        "CONFLUENCE_CLOUD": "true"
      }
    }
  }
}

For local development, point directly to the compiled output:

{
  "mcpServers": {
    "confluence-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"],
      "env": {
        "CONFLUENCE_URL": "...",
        "CONFLUENCE_USERNAME": "...",
        "CONFLUENCE_TOKEN": "...",
        "CONFLUENCE_CLOUD": "false"
      }
    }
  }
}

Environment Variables

| Variable | Description | |----------|-------------| | CONFLUENCE_URL | Your Confluence instance URL | | CONFLUENCE_USERNAME | Your username or email | | CONFLUENCE_TOKEN | Your API token or password | | CONFLUENCE_CLOUD | "true" for Cloud, "false" for Server |

Available Tools

Pages

• search — Search Confluence content (CQL)
• get_page — Get page content by ID
• get_page_children — Get child pages of a parent page
• create_page — Create a new page
• update_page — Update page content (inline HTML or file path)

Attachments

• get_attachments — List attachments on a page
• download_attachment — Download an attachment to local disk
• upload_attachment — Upload a local file as a page attachment, with optional embedding in page body

Comments

• get_comments — Get page comments
• add_comment — Add a comment to a page

Tool Examples

Search: ``json { "query": "space = DEV AND title ~ \"API\"", "limit": 10 } ``

Update page with inline content: ``json { "page_id": "123456", "content": "<h1>Title</h1><p>Updated content</p>" } ``

Update page from file (recommended for large content): ``json { "page_id": "123456", "content_file": "/absolute/path/to/content.html" } ``

Upload attachment: ``json { "page_id": "123456", "file_path": "/absolute/path/to/file.png" } ``

Upload and embed in page body: ``json { "page_id": "123456", "file_path": "/absolute/path/to/image.png", "embed_in_body": true, "comment": "Optional comment" } ``

Images are embedded as <ac:image>, other files as a view-file macro link.

Development

npm install
npm run build