Markdownify MCP Server
# Markdownify MCP Server
> Help! I need someone with a Windows computer to help me add support for Markdownify-MCP on Windows. PRs exist but I cannot test them. Post [here](https://github.com/zcaceres/markdownify-mcp/issues/18) if interested.
Markdownify is a Model Context Protocol (MCP) server that converts various file types and web content to Markdown format. It provides a set of tools to transform PDFs, images, audio files, web pages, and more into easily readable and shareable Markdown text.
<a href="https://glama.ai/mcp/servers/bn5q4b0ett"><img width="380" height="200" src="https://glama.ai/mcp/servers/bn5q4b0ett/badge" alt="Markdownify Server MCP server" /></a>
## Features
- Convert multiple file types to Markdown:
- PDF
- Images
- Audio (with transcription)
- DOCX
- XLSX
- PPTX
- Convert web content to Markdown:
- YouTube video transcripts
- Bing search results
- General web pages
- Retrieve existing Markdown files
## Getting Started
1. Clone this repository
2. Install dependencies:
```
pnpm install
```
Note: this will also install `uv` and related Python depdencies.
3. Build the project:
```
pnpm run build
```
4. Start the server:
```
pnpm start
```
## Development
- Use `pnpm run dev` to start the TypeScript compiler in watch mode
- Modify `src/server.ts` to customize server behavior
- Add or modify tools in `src/tools.ts`
## Usage with Desktop App
To integrate this server with a desktop app, add the following to your app's server configuration:
```js
{
"mcpServers": {
"markdownify": {
"command": "node",
"args": [
"{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
],
"env": {
// By default, the server will use the default install location of `uv`
"UV_PATH": "/path/to/uv"
}
}
}
}
```
## Available Tools
- `youtube-to-markdown`: Convert YouTube videos to Markdown
- `pdf-to-markdown`: Convert PDF files to Markdown
- `bing-search-to-markdown`: Convert Bing search results to Markdown
- `webpage-to-markdown`: Convert web pages to Markdown
- `image-to-markdown`: Convert images to Markdown with metadata
- `audio-to-markdown`: Convert audio files to Markdown with transcription
- `docx-to-markdown`: Convert DOCX files to Markdown
- `xlsx-to-markdown`: Convert XLSX files to Markdown
- `pptx-to-markdown`: Convert PPTX files to Markdown
- `get-markdown-file`: Retrieve an existing Markdown file. File extension must end with: *.md, *.markdown.
OPTIONAL: set `MD_SHARE_DIR` env var to restrict the directory from which files can be retrieved, e.g. `MD_SHARE_DIR=[SOME_PATH] pnpm run start`
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
TDQS
Scored across 13 tools
Most tools have clear distinct purposes focused on converting specific file types or sources to markdown, with minimal overlap. However, 'fetch' and 'get-markdown-file' could potentially cause confusion as both retrieve markdown content, though 'fetch' targets connector documents by ID while 'get-markdown-file' uses file paths.
The naming follows a consistent pattern where most tools use a clear 'source-to-markdown' format (e.g., 'pdf-to-markdown', 'webpage-to-markdown'), which is highly readable and predictable. Minor deviations include 'fetch' and 'search' which don't follow this pattern, and 'upload-file-for-conversion' uses underscores instead of hyphens, slightly breaking consistency.
With 13 tools, the count is well-scoped for a server focused on markdown conversion from various sources. Each tool serves a distinct conversion purpose (e.g., audio, DOCX, PDF, YouTube), and the inclusion of utility tools like 'upload-file-for-conversion' and 'search' supports the core functionality without bloat.
The tool set provides comprehensive coverage for converting common file types and online sources to markdown, including audio, documents, images, PDFs, webpages, and videos. Minor gaps exist, such as no tools for editing or processing markdown files after conversion, but the core conversion workflows are well-covered with support for local and remote files.