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