
Markitdown Setup
- 85 installs
- 9 repo stars
- Updated March 26, 2026
- heyman333/markitdown-skill
Installs markitdown-mcp and registers it as an MCP server in Claude Code settings via a bundled setup script.
About
Runs a setup script that installs markitdown-mcp and registers it in Claude Code settings. A developer runs it once before using the /convert command, then restarts Claude Code to activate the server.
- One-time bundled setup.sh install and MCP registration
- Prompts a Claude Code restart to activate the server
Markitdown Setup by the numbers
- 85 all-time installs (skills.sh)
- +2 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #339 of 688 Office & Documents skills by installs in the Skillselion catalog
- Data as of Aug 2, 2026 (Skillselion catalog sync)
npx skills add https://github.com/heyman333/markitdown-skill --skill markitdown-setupAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 85 |
|---|---|
| repo stars | ★ 9 |
| Last updated | March 26, 2026 |
| Repository | heyman333/markitdown-skill ↗ |
What it does
Installs markitdown-mcp and registers it as an MCP server in Claude Code settings via a bundled setup script.
Files
Run the setup script to install markitdown-mcp and register it in Claude Code:
!`bash "${CLAUDE_SKILL_DIR}/scripts/setup.sh"`After the script completes successfully, tell the user to restart Claude Code to activate the MCP server.
#!/usr/bin/env bash
# Helper script for markitdown-mcp installation and MCP registration.
set -e
# Install markitdown-mcp if not already installed
if ! command -v markitdown-mcp &>/dev/null; then
echo "Installing markitdown-mcp..."
pip install markitdown-mcp
else
echo "markitdown-mcp already installed at: $(which markitdown-mcp)"
fi
MCP_PATH=$(which markitdown-mcp)
# Register in Claude Code
if command -v claude &>/dev/null; then
if claude mcp list 2>/dev/null | grep -q "markitdown"; then
echo "markitdown MCP server is already registered in Claude Code."
else
claude mcp add -s user markitdown "$MCP_PATH"
echo "✅ markitdown MCP server registered in Claude Code. Please restart Claude Code to activate it."
fi
fi
# Register in Codex CLI
if command -v codex &>/dev/null; then
CODEX_CONFIG_DIR="$HOME/.codex"
CODEX_CONFIG="$CODEX_CONFIG_DIR/config.yaml"
mkdir -p "$CODEX_CONFIG_DIR"
if [ -f "$CODEX_CONFIG" ] && grep -q "markitdown" "$CODEX_CONFIG"; then
echo "markitdown MCP server is already registered in Codex CLI."
else
python3 - "$CODEX_CONFIG" "$MCP_PATH" <<'EOF'
import sys, os
config_path = sys.argv[1]
mcp_path = sys.argv[2]
# Read existing config
content = ""
if os.path.exists(config_path):
with open(config_path) as f:
content = f.read()
# Append mcpServers block if not present
if "mcpServers:" not in content:
content = content.rstrip() + ("\n" if content else "") + "mcpServers:\n"
if "markitdown:" not in content:
content += f" markitdown:\n command: {mcp_path}\n"
with open(config_path, "w") as f:
f.write(content)
print("Written to", config_path)
EOF
echo "✅ markitdown MCP server registered in Codex CLI. Please restart Codex to activate it."
fi
fi
if ! command -v claude &>/dev/null && ! command -v codex &>/dev/null; then
echo "⚠️ Neither Claude Code nor Codex CLI found. Please install one of them first."
exit 1
fi