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.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →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
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Categories
Registryactive
Packageshuck-convert
TransportSTDIO
UpdatedApr 17, 2026
