Summary
This server gives Claude two document conversion tools: doc_to_markdown pulls text, formatting, tables, and images from DOCX or PDF files into Markdown, while markdown_to_docx goes the other direction with opinionated academic styling (Times New Roman, SimSun, three-line tables). It's built on Pandoc for the Markdown to DOCX direction, so you'll need that installed. Reach for this when you want Claude to extract content from uploaded documents for analysis or rewriting, or when you need to generate formatted Word documents from Markdown that Claude produces. Also ships as a standalone CLI if you want to use it outside the MCP context.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →shuck-convert
Convert between document formats — DOCX/PDF to Markdown, Markdown to DOCX.
An MCP server for AI agents, with CLI support.
Tools
| Tool | Direction | Description |
|---|---|---|
doc_to_markdown | DOCX/PDF → MD | Extract text, formatting, tables, images |
markdown_to_docx | MD → DOCX | Academic styling: Times New Roman + SimSun, three-line tables |
Prerequisites
- Python 3.10+
- Pandoc (required for
markdown_to_docx)
Install
pip install shuck-convert
Or from source:
git clone https://github.com/Shan-Zhu/shuck-convert.git
cd shuck-convert
pip install -e .
Usage
MCP Server (for AI agents)
Add to your MCP client config:
{
"mcpServers": {
"shuck-convert": {
"command": "shuck-convert",
"args": [],
"transportType": "stdio"
}
}
}
Or with uvx:
{
"mcpServers": {
"shuck-convert": {
"command": "uvx",
"args": ["shuck-convert"],
"transportType": "stdio"
}
}
}
CLI
# DOCX/PDF to Markdown
shuck-convert doc2md report.docx
shuck-convert doc2md paper.pdf
# Markdown to DOCX
shuck-convert md2docx paper.md
Development
pip install -e .
fastmcp dev src/shuck_convert/server.py
License
MIT
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Categories
Registryactive
Packageshuck-convert
TransportSTDIO
UpdatedApr 17, 2026
