Enables converting Markdown documents to professionally styled Confluence pages with support for Mermaid diagrams, offering tools to list spaces, list pages, create new pages, update existing pages, and delete pages.
Provides deployment configuration and instructions specifically optimized for Fly.io, including secret management and deployment commands.
Converts Markdown content to Confluence storage format, maintaining formatting elements like headings, bold/italic text, and supporting Mermaid diagrams.
Renders Mermaid diagrams as PNG images that can be embedded in Confluence pages, allowing for visualization of workflows and diagrams.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Confluence MCP Server create a new page in the Engineering space with this project overview markdown"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Model Context Protocol (MCP) server that enables AI assistants to interact with Confluence, converting Markdown documents to professionally styled Confluence pages with Mermaid diagram support.
🔄 SSE Server: Real-time Server-Sent Events for live progress updates
📝 Markdown to Confluence: Convert Markdown content to Confluence storage format
📊 Mermaid Diagrams: Render Mermaid diagrams as images in Confluence pages
🎨 Professional Styling: Modern, clean page layouts
💾 Smart Caching: Local cache to link markdown files to Confluence pages
🔒 Secure Authentication: Confluence API token authentication
☁️ Fly.io Ready: Optimized for deployment on Fly.io
Related MCP server: Confluence MCP Server
confluence_list_spaces - List all available Confluence spaces
confluence_list_pages - List pages in a specific space
confluence_create_page - Create new pages from Markdown content
confluence_update_page - Update existing pages with new content
confluence_delete_page - Delete pages and clean up cache
git clone <repository-url>
cd confluence-mcp
npm installCopy the example environment file and configure your Confluence credentials:
cp .env.example .envEdit .env with your Confluence details:
CONFLUENCE_BASE_URL=https://your-domain.atlassian.net
CONFLUENCE_USERNAME=your-email@domain.com
CONFLUENCE_API_TOKEN=your-api-token
MCP_API_KEY=your-mcp-api-key
PORT=3001Click "Create API token"
Give it a label and copy the token
Use your email as username and the token as password
# Development
npm run dev
# Production
npm run build
npm startThe server will be available at http://localhost:3001
# My Documentation
This is a sample page with a Mermaid diagram:
```mermaid
graph TD
A[Start] --> B[Process]
B --> C[End]Some bold text and italic text.
The MCP server will:
1. Convert the Markdown to Confluence storage format
2. Render the Mermaid diagram as a PNG image
3. Create a professionally styled page
4. Cache the mapping for future updates
### Update an Existing Page
When you update a markdown file, the server can automatically update the corresponding Confluence page using the cached mapping.
## API Endpoints
### SSE Endpoints
- `GET /mcp` - Establish SSE connection for MCP protocol
- `POST /messages` - Send MCP messages (requires sessionId)
### Health Check
- `GET /health` - Server health status
## Deployment on Fly.io
### 1. Install Fly CLI
```bash
# macOS
brew install flyctl
# Other platforms: https://fly.io/docs/getting-started/installing-flyctl/fly auth login
fly launchfly secrets set CONFLUENCE_BASE_URL=https://your-domain.atlassian.net
fly secrets set CONFLUENCE_USERNAME=your-email@domain.com
fly secrets set CONFLUENCE_API_TOKEN=your-api-token
fly secrets set MCP_API_KEY=your-mcp-api-keyfly deploy┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ AI Assistant │◄──►│ MCP Server │◄──►│ Confluence │
│ │ │ (SSE/HTTP) │ │ API │
└─────────────────┘ └──────────────────┘ └─────────────────┘
│
▼
┌──────────────────┐
│ Local Cache │
│ (JSON file) │
└──────────────────┘confluence-mcp/
├── src/
│ ├── index.ts # Entry point
│ ├── server.ts # MCP server with SSE support
│ ├── services/
│ │ ├── confluence-client.ts # Confluence API client
│ │ ├── markdown-converter.ts # Markdown to Confluence converter
│ │ └── mermaid-renderer.ts # Mermaid diagram renderer
│ ├── utils/
│ │ ├── cache.ts # Local cache management
│ │ └── config.ts # Configuration management
│ └── types/
│ └── index.ts # TypeScript type definitions
├── fly.toml # Fly.io configuration
├── package.json
└── tsconfig.jsonnpm run build# Test health endpoint
curl http://localhost:3001/health
# Test SSE connection
curl -N http://localhost:3001/mcpFork the repository
Create a feature branch
Make your changes
Add tests if applicable
Submit a pull request
MIT License - see LICENSE file for details
This server cannot be deployed
Clean, repair, and convert AI-generated Markdown to HTML/PDF/DOCX/PNG; save and share documents.
Publish markdown documents as public share links with mermaid diagram support. Built by AutEng.ai
Publish markdown documents as public share links with mermaid diagrams. Built by AutEng.ai
Generate dynamic Mermaid diagrams and charts with AI assistance. Customize styles and export diagr…
