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:

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

Update page with inline content:

{ "page_id": "123456", "content": "<h1>Title</h1><p>Updated content</p>" }

Update page from file (recommended for large content):

{ "page_id": "123456", "content_file": "/absolute/path/to/content.html" }

Upload attachment:

{ "page_id": "123456", "file_path": "/absolute/path/to/file.png" }

Upload and embed in page body:

{
  "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