Confluence Downloader

A Kiro Power and MCP server for downloading Confluence Cloud pages as Markdown with images.

Features

• Download entire spaces with folder hierarchy preserved

• Download single pages or page trees (page + all descendants)

• Images downloaded locally with markdown-compatible references

• Multi-org support (override Confluence URL per request)

• YAML frontmatter on each page (title, source URL, export timestamp)

• Rate limiting, retry logic and exponential backoff

Related MCP server: MCP Confluence Server

Install as a Kiro Power

In Kiro, open the Powers panel and use "Add Custom Power" → "Import from GitHub" with this repo URL.

After installing, configure your credentials in the Power's MCP settings:

Generate tokens at id.atlassian.com. The token must be unscoped; scoped tokens return 403 on the classic REST API.

Install standalone

pip install confluence-downloader-mcp

Or run directly with uvx:

uvx confluence-downloader-mcp

Available tools

MCP configuration

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

{
  "mcpServers": {
    "confluence-downloader": {
      "command": "uvx",
      "args": ["confluence-downloader-mcp"],
      "env": {
        "CONFLUENCE_URL": "https://your-site.atlassian.net",
        "CONFLUENCE_EMAIL": "you@example.com",
        "CONFLUENCE_API_TOKEN": "your-api-token"
      }
    }
  }
}

Output

Files are saved to ./confluence-export/ in the current workspace by default. Pass output_dir to any download tool to save elsewhere.

License

MIT