About Md2confluence MCP
Md2confluence MCP is an MCP server published by Gyeom in the Developer Tools category: mCP server to upload Markdown to Confluence. Auto-converts Mermaid diagrams, code blocks, images, and tables.
The repository has 15 stars and 2 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/Gyeom/md2confluence-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (6)
create_child_pageCreate a new page under an existing page
Parameters not published.
list_spacesList available spaces
Parameters not published.
search_pagesSearch for pages
Parameters not published.
sync_fileSync a local file to an existing page
Parameters not published.
update_pageUpdate an existing page
Parameters not published.
upload_pageCreate a new Confluence page from Markdown
Parameters not published.
Ask AI
Ask AI about Md2confluence MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository yesterday. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
md2confluence-mcp
Markdown to Confluence converter — MCP server that uploads Markdown files to Atlassian Confluence with auto-converted Mermaid diagrams, code blocks, and images.
Demo
Uploading showcase.md to Confluence with images and Mermaid diagrams
Features
- ✅ Mermaid diagrams → PNG (auto-converted via kroki.io)
- ✅ Code blocks → Confluence Code macro
- ✅ Images → Attachments (auto-uploaded)
- ✅ Tables, links, formatting → Preserved
Installation
Claude Code
Add to your Claude Code settings (~/.claude/settings.json):
{
"mcpServers": {
"confluence": {
"command": "npx",
"args": ["-y", "md2confluence-mcp"],
"env": {
"CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
"CONFLUENCE_EMAIL": "your@email.com",
"CONFLUENCE_TOKEN": "YOUR_API_TOKEN"
}
}
}
}
Project-specific
Add to your project's .mcp.json:
{
"mcpServers": {
"confluence": {
"command": "npx",
"args": ["-y", "md2confluence-mcp"],
"env": {
"CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
"CONFLUENCE_EMAIL": "your@email.com",
"CONFLUENCE_TOKEN": "YOUR_API_TOKEN"
}
}
}
}
Get API Token
- Go to https://id.atlassian.com/manage/api-tokens
- Click "Create API token"
- Copy the token to
CONFLUENCE_TOKEN
Usage
Once configured, Claude Code can use these tools automatically.
Prompt Examples
Upload to your personal space
"Upload README.md to my personal Confluence space"
"Upload this document to my Confluence space"
Upload to a specific space (with URL)
"Upload docs/SETUP.md to Confluence here: https://company.atlassian.net/wiki/spaces/TEAM/overview"
"Create a new page in https://company.atlassian.net/wiki/spaces/~712020170fdaa4716743419285f156aa587665/overview with this content"
Update an existing page
"Update this Confluence page with the latest content: https://company.atlassian.net/wiki/spaces/TEAM/pages/123456/My+Page"
"Sync docs/API.md to https://company.atlassian.net/wiki/spaces/EN/pages/789012/API+Reference"
Create a child page (sub-page)
"Create a new page under https://company.atlassian.net/wiki/spaces/TEAM/pages/123456/Parent+Page"
"Add a sub-page to this page: https://company.atlassian.net/wiki/spaces/EN/pages/789012/Guide"
List and search
"Show me available Confluence spaces"
"Find Confluence pages about authentication in the EN space"
Space Key Format
| Type | Format | Example |
|---|---|---|
| Global space | Short key | TEAM, EN, PROD |
| Personal space | ~ + ID |
~712020170fdaa4716743419285f156aa587665 |
Tip: You can extract the space key from a Confluence URL:
https://company.atlassian.net/wiki/spaces/TEAM/overview
^^^^ space key
https://company.atlassian.net/wiki/spaces/~712020.../overview
^^^^^^^^^^ personal space key
Tools
| Tool | Description |
|---|---|
upload_page |
Create a new Confluence page from Markdown |
update_page |
Update an existing page |
create_child_page |
Create a new page under an existing page |
sync_file |
Sync a local file to an existing page |
list_spaces |
List available spaces |
search_pages |
Search for pages |
How It Works
flowchart LR
A["Markdown"] --> B["Parse"]
B --> C["Mermaid → kroki.io → PNG"]
C --> D["Convert to Confluence HTML"]
D --> E["Upload via REST API"]
E --> F["Attach images"]
- Parse - Extract content, remove front matter
- Render - Convert Mermaid diagrams to PNG via kroki.io
- Convert - Transform Markdown to Confluence storage format
- Upload - Create/update page via Confluence REST API
- Attach - Upload images as page attachments
Environment Variables
| Variable | Required | Description |
|---|---|---|
CONFLUENCE_URL |
✅ | e.g., https://your-domain.atlassian.net/wiki |
CONFLUENCE_EMAIL |
✅ | Your Atlassian account email |
CONFLUENCE_TOKEN |
✅ | API token |
Development
# Clone
git clone https://github.com/Gyeom/md2confluence-mcp.git
cd md2confluence-mcp
# Install dependencies
npm install
# Build
npm run build
# Test locally
CONFLUENCE_URL=... CONFLUENCE_EMAIL=... CONFLUENCE_TOKEN=... npm start
License
MIT
Credits
- kroki.io - Diagram rendering API
- Model Context Protocol - MCP SDK
- Confluence REST API
README fetched from the repository yesterday. The original is authoritative.