Markdown Convert MCP

MCP server that converts Markdown (CommonMark and GFM) to Slack, Microsoft Teams, Jira, and plain text for agent and automation workflows.

Documentation

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