1. Conduid
  2. Developer Tools
  3. Md2confluence MCP
MCP server · Developer Tools

Md2confluence MCP

by · github.com/Gyeom/md2confluence-mcp

MCP server to upload Markdown to Confluence. Auto-converts Mermaid diagrams, code blocks, images, and tables.

Unclaimed MIT last commit 6 months ago model-context-protocolconfluencemarkdownmcpmermaidmarkdown-to-confluenceatlassiandevtoolsdocumentation
InstallView source
67Good

Scored 1 hours ago · breakdown

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. It has been installed 0 times through Conduid.

The repository has 12 stars and 1 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.

Install

Install
npx md2confluence-mcp

This 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.

Ask AI

✦

Ask AI about Md2confluence MCP

Powered by Claude · Grounded in docs

I know everything about Md2confluence MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ·README presentNot checked yet.
  • ·License declaredNot checked yet.
  • ·Tests presentNot checked yet.
  • ·Dependencies pinnedNot checked yet.
  • ·No dynamic code executionNot checked yet.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

Releases

v0.1.2v0.1.2
v0.1.1v0.1.1

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.

npm

Demo

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

  1. Go to https://id.atlassian.com/manage/api-tokens
  2. Click "Create API token"
  3. 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"]
  1. Parse - Extract content, remove front matter
  2. Render - Convert Mermaid diagrams to PNG via kroki.io
  3. Convert - Transform Markdown to Confluence storage format
  4. Upload - Create/update page via Confluence REST API
  5. 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

README mirrored from the source repository 1 hours ago. The original is authoritative.

Questions

About Md2confluence MCP

How do I install Md2confluence MCP?

Run npx md2confluence-mcp, then add the server to your MCP client's configuration. Conduid has recorded 0 installs, so the command is known to work with current clients.

Is Md2confluence MCP safe to use with an AI agent?

Its trust score is 67 out of 100 (good). It passes 0 of 1 static security checks; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Md2confluence MCP still maintained?

The last commit was 6 months ago, with 0 open issues. That's long enough that you should check whether the maintainer is responding to issues before depending on it.