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):```bash
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)```text
/plugin marketplace add ysskrishna/markdown-convert-mcp
/plugin install markdown-convert-mcp@markdown-convert-mcp
Companion skill only:```text
/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:```bash
claude mcp add markdown-convert -- npx -y @ysskrishna/markdown-convert-mcp
Codex CLI```bash
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```bash
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```bash
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.```bash
gh skill install ysskrishna/markdown-convert-mcp markdown-convert
ClawHub (per-skill)```bash
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):```json
{
"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```bash
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:```json
{
"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):```json
{
"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):```json
{
"mcpServers": {
"markdown-convert": {
"command": "npx",
"args": ["-y", "@ysskrishna/markdown-convert-mcp"]
}
}
}
Windows (cmd /c wrapper)
Some hosts on Windows need cmd to resolve npx:```json
{
"mcpServers": {
"markdown-convert": {
"command": "cmd",
"args": ["/c", "npx", "-y", "@ysskrishna/markdown-convert-mcp"]
}
}
}
npm global```bash
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:```bash
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):```bash
openclaw plugins install clawhub:@ysskrishna/markdown-convert-mcp
Inspect before install:bash
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": "" } 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 | — |
Example inputs and real outputs for every tool are in docs/tools.md.
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.
Author's GitHub •
Author's LinkedIn •
Author's site •
npm package •
MCP Registry •
repository •
Report Issues
