Markdown Convert MCP
MCP server: convert Markdown to Slack, Teams, Jira, and plain text
Markdown Convert MCP
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.
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
| Skill | Use it when | Registry |
|---|---|---|
markdown-convert | The agent will paste or post into Slack, Teams, Jira, or needs stripped text next. |
Tools and next hops
Each tool accepts { "markdown": "<source>" } and returns converted text. Pick the tool that matches where the string will go next.
| Tool | Output | Use when the next hop expects | Do not use when |
|---|---|---|---|
markdown_to_slack | Slack mrkdwn | Slack API or Slack MCP text (mrkdwn) | Composer clipboard paste; markdown_text fields (pass Markdown through instead) |
markdown_to_teams | HTML with inline CSS | Teams paste or Graph contentType: html | Adaptive Cards; this tool does not send Teams messages |
markdown_to_jira | ADF JSON string | Jira Cloud REST v3 rich-text fields; Atlassian MCP | Wiki markup / Server v2 API; this tool does not create issues |
markdown_to_plaintext | Plain text | Any 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:
| Name | GitHub | Role | |
|---|---|---|---|
![]() | Y. Siva Sai Krishna | @ysskrishna | Creator |
Changelog
See CHANGELOG for release history.
Support
If you find this project helpful:
- Star the repository
- Report issues
- Submit pull requests
- Sponsor on GitHub
License
MIT © Y. Siva Sai Krishna — see LICENSE for details.
MCP Registry • npm • Author's GitHub • Author's LinkedIn • Author's site • Report Issues

