Markdownify MCP Server

1# Markdownify MCP Server
2 
3> 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.
4 
5![markdownify mcp logo](logo.jpg)
6 
7Markdownify 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.
8 
9<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>
10 
11## Features
12 
13- Convert multiple file types to Markdown:
14  - PDF
15  - Images
16  - Audio (with transcription)
17  - DOCX
18  - XLSX
19  - PPTX
20- Convert web content to Markdown:
21  - YouTube video transcripts
22  - Bing search results
23  - General web pages
24- Retrieve existing Markdown files
25 
26## Getting Started
27 
281. Clone this repository
292. Install dependencies:
30   ```
31   pnpm install
32   ```
33 
34Note: this will also install `uv` and related Python depdencies.
35 
363. Build the project:
37   ```
38   pnpm run build
39   ```
404. Start the server:
41   ```
42   pnpm start
43   ```
44 
45## Development
46 
47- Use `pnpm run dev` to start the TypeScript compiler in watch mode
48- Modify `src/server.ts` to customize server behavior
49- Add or modify tools in `src/tools.ts`
50 
51## Usage with Desktop App
52 
53To integrate this server with a desktop app, add the following to your app's server configuration:
54 
55```js
56{
57  "mcpServers": {
58    "markdownify": {
59      "command": "node",
60      "args": [
61        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
62      ],
63      "env": {
64        // By default, the server will use the default install location of `uv`
65        "UV_PATH": "/path/to/uv"
66      }
67    }
68  }
69}
70```
71 
72## Available Tools
73 
74- `youtube-to-markdown`: Convert YouTube videos to Markdown
75- `pdf-to-markdown`: Convert PDF files to Markdown
76- `bing-search-to-markdown`: Convert Bing search results to Markdown
77- `webpage-to-markdown`: Convert web pages to Markdown
78- `image-to-markdown`: Convert images to Markdown with metadata
79- `audio-to-markdown`: Convert audio files to Markdown with transcription
80- `docx-to-markdown`: Convert DOCX files to Markdown
81- `xlsx-to-markdown`: Convert XLSX files to Markdown
82- `pptx-to-markdown`: Convert PPTX files to Markdown
83- `get-markdown-file`: Retrieve an existing Markdown file. File extension must end with: *.md, *.markdown.
84  
85  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` 
86 
87## Contributing
88 
89Contributions are welcome! Please feel free to submit a Pull Request.
90 
91## License
92 
93This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
94