Markdown Convert MCP

MCP-сервер, преобразующий Markdown (CommonMark и GFM) в форматы Slack, Microsoft Teams, Jira и обычный текст для рабочих процессов с агентами и автоматизацией.

Документация

Markdown Convert MCP

npm version CI Node License: MIT MCP Registry npm downloads

Convert Markdown to Slack, Microsoft Teams, Jira, and plain text with an MCP server. Supports CommonMark and GitHub-Flavored Markdown (GFM) and provides platform-specific formatting for AI agents, LLMs, and automation workflows.

Listed on the official MCP Registry as io.github.ysskrishna/markdown-convert-mcp.

Markdown Convert MCP

Installation

Fastest path (works in most MCP hosts):

npx -y @ysskrishna/markdown-convert-mcp

Point your host at npx with args ["-y", "@ysskrishna/markdown-convert-mcp"], or use the plugin, skill, or host snippets below.

Claude Code (plugin marketplace)
/plugin marketplace add ysskrishna/markdown-convert-mcp
/plugin install markdown-convert-mcp@markdown-convert-mcp

Companion skill only:

/plugin install markdown-convert@markdown-convert-mcp

The markdown-convert-mcp plugin registers the MCP server and the skill together. If you install only the skill (markdown-convert), add the MCP server yourself:

claude mcp add markdown-convert -- npx -y @ysskrishna/markdown-convert-mcp

Codex CLI
codex plugin marketplace add ysskrishna/markdown-convert-mcp
codex plugin add markdown-convert-mcp@markdown-convert-mcp

The Codex plugin installs the skill only and does not register the MCP server. Add the server in Codex MCP settings with npx and args ["-y", "@ysskrishna/markdown-convert-mcp"].

GitHub Copilot CLI
copilot plugin marketplace add ysskrishna/markdown-convert-mcp
copilot plugin install markdown-convert-mcp@markdown-convert-mcp

Cursor (plugin)

In Cursor: Customize → Plugins → Add → From GitHub Repository → github.com/ysskrishna/markdown-convert-mcp, or in Agent chat: /add-plugin.

The plugin includes the markdown-convert skill; register the MCP server under Settings → MCP (see Cursor MCP below).

skills.sh
npx skills add ysskrishna/markdown-convert-mcp --skill markdown-convert

MCP server: use the npx config or a host-specific MCP block below.

GitHub CLI (gh skill)

Requires GitHub CLI v2.90.0 or later.

gh skill install ysskrishna/markdown-convert-mcp markdown-convert

ClawHub (per-skill)
clawhub install markdown-convert

Browse: clawhub.ai/ysskrishna/markdown-convert. For the full MCP bundle, see OpenClaw (ClawHub).

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

{
  "mcpServers": {
    "markdown-convert": {
      "command": "npx",
      "args": ["-y", "@ysskrishna/markdown-convert-mcp"]
    }
  }
}

Open Cursor Settings → MCP and enable markdown-convert.

With a global install, use "command": "markdown-convert-mcp" instead of npx.

Claude Code
claude mcp add markdown-convert -- npx -y @ysskrishna/markdown-convert-mcp

Add -s user for all projects. In a session, run /mcp to list tools.

Claude Desktop

Settings → Developer → Edit Config, then restart Claude:

{
  "mcpServers": {
    "markdown-convert": {
      "command": "npx",
      "args": ["-y", "@ysskrishna/markdown-convert-mcp"]
    }
  }
}

VS Code (and Copilot MCP)

Add to your user or workspace MCP config (for example .vscode/mcp.json or GitHub Copilot → MCP settings):

{
  "servers": {
    "markdown-convert": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@ysskrishna/markdown-convert-mcp"]
    }
  }
}

Restart or reload MCP after saving.

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json (or the MCP section in Windsurf settings):

{
  "mcpServers": {
    "markdown-convert": {
      "command": "npx",
      "args": ["-y", "@ysskrishna/markdown-convert-mcp"]
    }
  }
}

Windows (cmd /c wrapper)

Some hosts on Windows need cmd to resolve npx:

{
  "mcpServers": {
    "markdown-convert": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@ysskrishna/markdown-convert-mcp"]
    }
  }
}

npm global
npm install -g @ysskrishna/markdown-convert-mcp

Then use "command": "markdown-convert-mcp" with no args in your MCP config.

MCP Inspector (development)

After npm run build, or against the published package:

npx @modelcontextprotocol/inspector npx -y @ysskrishna/markdown-convert-mcp

For a local checkout, swap in node /absolute/path/to/markdown-convert-mcp/dist/index.js.

OpenClaw (ClawHub)

Install the bundle-plugin from ClawHub (registers the markdown-convert MCP server and the companion markdown-convert skill):

openclaw plugins install clawhub:@ysskrishna/markdown-convert-mcp

Inspect before install:

clawhub package inspect @ysskrishna/markdown-convert-mcp

Reload OpenClaw after install.

Maintainer publish after each version tag: python3 scripts/publish_clawhub.py plan / publish (skill), then python3 scripts/publish_clawhub.py package plan / package publish (bundle). See DEVELOPMENT.md.

Companion skill

SkillUse it whenRegistry
markdown-convertThe agent will paste or post into Slack, Teams, Jira, or needs stripped text next.Clawhub

Tools and next hops

Each tool accepts { "markdown": "<source>" } and returns converted text. Pick the tool that matches where the string will go next.

ToolOutputUse when the next hop expectsDo not use when
markdown_to_slackSlack mrkdwnSlack API or Slack MCP text (mrkdwn)Composer clipboard paste; markdown_text fields (pass Markdown through instead)
markdown_to_teamsHTML with inline CSSTeams paste or Graph contentType: htmlAdaptive Cards; this tool does not send Teams messages
markdown_to_jiraADF JSON stringJira Cloud REST v3 rich-text fields; Atlassian MCPWiki markup / Server v2 API; this tool does not create issues
markdown_to_plaintextPlain textAny destination that needs stripped text—

Limits: Whitespace-only input returns success with an empty string. Input over 200,000 characters returns a tool error (isError: true), not a transport failure. Slack may truncate around 40k characters in the text field.

Built and maintained by

Markdown Convert MCP is built and maintained by:

NameGitHubRole
Y. Siva Sai KrishnaY. Siva Sai Krishna@ysskrishnaCreator

Changelog

See CHANGELOG for release history.

Support

If you find this project helpful:

License

MIT © Y. Siva Sai Krishna — see LICENSE for details.


MCP Registry • npm • Author's GitHub • Author's LinkedIn • Author's site • Report Issues