drawio-confluence

Manage draw.io diagram attachments on Confluence pages via MCP toolsets.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/keathmilligan/drawio-skill --skill drawio-confluence
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: drawio-confluence
Source: https://github.com/keathmilligan/drawio-skill/tree/main/drawio-confluence
Command: npx skills add https://github.com/keathmilligan/drawio-skill --skill drawio-confluence

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Download, upload, and update draw.io diagrams on Confluence pages using the sooperset/mcp-atlassian MCP server (Atlassian MCP). This skill enables end-to-end diagram management, ensuring diagrams are attached, versioned, and easily editable from Confluence pages.

Core Features & Use Cases

  • Attachment management: Download existing .drawio diagrams, upload new diagrams, and update attachments on Confluence pages.
  • MCP-enabled operations: Leverage confluence_pages and confluence_attachments toolsets to create, search, and manage pages and attachments.
  • Versioned diagrams: Every update creates a new attachment version preserving history, with options to embed diagrams or provide downloads as needed.
  • Use Case: Maintain system architecture diagrams across Dev spaces by keeping a single source of truth on Confluence.

Quick Start

Identify the target Confluence page and run the drawio-confluence workflow to download, upload, or update the diagram attachment.

Frequently Asked Questions about drawio-confluence

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage draw.io diagrams on Confluence pages using MCP?

You can manage draw.io diagrams on Confluence pages by running the drawio-confluence workflow via the sooperset/mcp-atlassian server. It handles downloading, uploading, and updating diagram attachments directly through MCP toolsets.

Can I automate uploading and updating draw.io architecture diagrams on Confluence?

Yes, automating draw.io architecture diagram uploads and updates on Confluence is supported. The workflow leverages confluence_attachments and confluence_pages toolsets to apply versioned attachments to target pages programmatically.

Does the Atlassian MCP server support versioned diagram attachments for Confluence?

The Atlassian MCP server supports versioned diagram attachments for Confluence. Every update executed through the workflow creates a new attachment version, preserving the diagram history.

What's the best way to maintain system architecture diagrams across multiple Confluence Dev spaces?

The best way to maintain system architecture diagrams across Confluence Dev spaces is using automated attachment management. This ensures a single source of truth by keeping diagrams versioned and editable directly on Confluence pages.

How do I find and attach a draw.io file to a specific Confluence page via MCP?

To attach a draw.io file to a specific Confluence page via MCP, the workflow searches for the target page using the confluence_pages toolset, then applies the confluence_attachments toolset to upload and manage the diagram.

Do I need the sooperset/mcp-atlassian server to run draw.io diagram operations on Confluence?

Yes, the sooperset/mcp-atlassian server is required. The drawio-confluence workflow enforces all attachment and page operations through its specific confluence_pages and confluence_attachments MCP toolsets.