md2confluence-mcp
Provides an MCP server that converts Markdown to Atlassian Confluence content and uploads it (create/update page) including Mermaid diagrams (rendered to PNG via kroki.io), images (uploaded as Confluence attachments), code blocks (Confluence code macro), and preserves tables/links/formatting.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
Uses an Atlassian API token (better than no auth). Scope granularity is not described (likely token-based with broad permissions). Mermaid diagrams are rendered via an external service (kroki.io), which may expose diagram content to a third party. README does not mention TLS enforcement details, secret logging, or rate-limit handling.
⚡ Reliability
Best When
You want an agent-friendly workflow (e.g., Claude Code) to push/update Confluence documentation from Markdown and your Confluence token has the necessary permissions.
Avoid When
You cannot allow outbound requests to kroki.io for Mermaid rendering or you need strong guarantees around idempotency/rollback, because such behavior is not documented here.
Use Cases
- • Automate creation of Confluence pages from Markdown docs
- • Keep Confluence documentation synchronized with a source Markdown repo
- • Render Mermaid diagrams in Confluence by converting them to images automatically
- • Publish technical documentation that includes code blocks, tables, links, and formatted text
Not For
- • Use when you need offline/no external diagram rendering (uses kroki.io)
- • Use when you require fine-grained Confluence permissions mapping beyond what the API token grants
- • Use when you need strict, deterministic idempotent page syncing without verification logic (not described)
Interface
Authentication
Authentication is configured via environment variables (CONFLUENCE_URL, CONFLUENCE_EMAIL, CONFLUENCE_TOKEN). The README does not describe OAuth flows or scope granularity.
Pricing
Pricing for the MCP server itself is not stated; it appears to be an open-source npm package. Costs may exist from Atlassian API usage and external diagram rendering (kroki.io), but not documented here.
Agent Metadata
Known Gotchas
- ⚠ Mermaid rendering relies on kroki.io; failures/timeouts there could break conversion.
- ⚠ The README shows conversational prompt examples but does not document exact tool input schemas, required parameters, or how conflicts are resolved when pages already exist.
- ⚠ Idempotency and safe update semantics are not described; repeated uploads may create multiple pages or overwrite content depending on implementation.
Alternatives
Full Evaluation Report
Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for md2confluence-mcp.
AI-powered analysis · PDF + markdown · Delivered within 30 minutes
Package Brief
Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.
Delivered within 10 minutes
Score Monitoring
Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.
Continuous monitoring
Scores are editorial opinions as of 2026-03-30.