Markdown Downloader

by dazeb

20 stars

428 downloads

Not rated

GitHub Website

About

Downloads and processes Markdown content from URLs, enabling tasks like content aggregation, documentation management, and text analysis.

Details

Author: dazeb
Repository: dazeb/markdown-downloader
GitHub stars: 20
Downloads: 428
License: MIT License
Categories: Web Scraping, Other, Productivity, Developer Tools, Design, Workplace, File Management, AI, Project Management, Frontend
Tags: #web, #mobile

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Markdown Downloader

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /home/user/Documents/Cline/MCP/markdown-downloader/build/index.js
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

JSON

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "C:\\Users\\username\\Documents\\Cline\\MCP\\markdown-downloader\\build\\index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

JSON

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

JSON

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "C:\\Users\\username\\Documents\\Cline\\MCP\\markdown-downloader\\build\\index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

JSON

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

JSON

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "C:\\Users\\username\\Documents\\Cline\\MCP\\markdown-downloader\\build\\index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

JSON

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

JSON

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "C:\\Users\\username\\Documents\\Cline\\MCP\\markdown-downloader\\build\\index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

JSON

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

JSON

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "C:\\Users\\username\\Documents\\Cline\\MCP\\markdown-downloader\\build\\index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

JSON

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

From the repository

To install Markdown Downloader for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @dazeb/markdown-downloader --client claude

1. Clone the repository:

   git clone https://github.com/your-username/markdown-downloader.git

   cd markdown-downloader

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

`set_download_directory`

Change the download directory. Validates that the directory exists and is writable, and persists the configuration for future use.

`download_markdown`

Download a webpage as a markdown file from a specified URL. The URL will be prepended with 'r.jina.ai', and the filename format will be '{sanitized-url}-{date}.md', saved in the configured download directory.

`list_downloaded_files`

List all downloaded markdown files.

`get_download_directory`

Retrieve the current download directory.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "markdown downloader": {
            "env": {},
            "args": [
                "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
            ],
            "command": "node",
            "disabled": false,
            "alwaysAllow": [
                "download_markdown",
                "set_download_directory"
            ]
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
    ],
    "command": "node",
    "disabled": false,
    "alwaysAllow": [
        "download_markdown",
        "set_download_directory"
    ]
}

Macos

{
    "env": [],
    "args": [
        "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
    ],
    "command": "node",
    "disabled": false,
    "alwaysAllow": [
        "download_markdown",
        "set_download_directory"
    ]
}

Windows

{
    "env": [],
    "args": [
        "C:\\Users\\username\\Documents\\Cline\\MCP\\markdown-downloader\\build\\index.js"
    ],
    "command": "node",
    "disabled": false,
    "alwaysAllow": [
        "download_markdown",
        "set_download_directory"
    ]
}

Markdown Downloader MCP Server

Overview

Markdown Downloader is a powerful MCP (Model Context Protocol) server that allows you to download webpages as markdown files with ease. Leveraging the r.jina.ai service, this tool provides a seamless way to convert web content into markdown format.

Features

Prerequisites

- Node.js (version 16 or higher)
- npm (Node Package Manager)

Installation

Installing via Smithery

To install Markdown Downloader for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @dazeb/markdown-downloader --client claude

Installing manually

1. Clone the repository:

   git clone https://github.com/your-username/markdown-downloader.git

   cd markdown-downloader

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

Manually Add Server to Cline/Roo-Cline MCP Settings file

Linux/macOS

{
  "mcpServers": {
    "markdown-downloader": {
      "command": "node",
      "args": [
        "/home/user/Documents/Cline/MCP/markdown-downloader/build/index.js"
      ],
      "disabled": false,
      "alwaysAllow": [
        "download_markdown",
        "set_download_directory"
      ]
    }
  }
}

Windows

{
  "mcpServers": {
    "markdown-downloader": {
      "command": "node",
      "args": [
        "C:\\Users\\username\\Documents\\Cline\\MCP\\markdown-downloader\\build\\index.js"
      ],
      "disabled": false,
      "alwaysAllow": [
        "download_markdown",
        "set_download_directory"
      ]
    }
  }
}

Tools and Usage

1. Set Download Directory

Change the download directory:

use set_download_directory /path/to/your/local/download/folder

- Validates directory exists and is writable
- Persists the configuration for future use

2. Download Markdown

Download a webpage as a markdown file:

use tool download_markdown https://example.com/blog-post

- The URL will be prepended with r.jina.ai
- Filename format: {sanitized-url}-{date}.md
- Saved in the configured download directory

3. List Downloaded Files

List all downloaded markdown files:

use list_downloaded_files

4. Get Download Directory

Retrieve the current download directory:

use get_download_directory

Configuration

Linux/macOS

- Configuration is stored in ~/.config/markdown-downloader/config.json - Default download directory: ~/.markdown-downloads

Windows

- Configuration is stored in %APPDATA%\markdown-downloader\config.json - Default download directory: %USERPROFILE%\Documents\markdown-downloads

Troubleshooting

- Ensure you have an active internet connection
- Check that the URL is valid and accessible
- Verify write permissions for the download directory

Security

- The tool uses r.jina.ai to fetch markdown content
- Local files are saved with sanitized filenames
- Configurable download directory allows flexibility

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Disclaimer

This tool is provided as-is. Always review downloaded content for accuracy and appropriateness.

Support

For issues or feature requests, please open an issue on the GitHub repository.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

set_download_directory

download_markdown

list_downloaded_files

get_download_directory

Claude Desktop / Cursor

Linux

Macos

Windows

Markdown Downloader MCP Server

Overview

Features

Prerequisites

Installation

Installing via Smithery

Installing manually

Manually Add Server to Cline/Roo-Cline MCP Settings file

Linux/macOS

Windows

Tools and Usage

1. Set Download Directory

2. Download Markdown

3. List Downloaded Files

4. Get Download Directory

Configuration

Linux/macOS

Windows

Troubleshooting

Security

Contributing

License

Disclaimer

Support

Install

More like this

@mendableai/firecrawl Mcp Server

Sequential Thinking

Time

Filesystem

EverArt

Google Drive

`set_download_directory`

`download_markdown`

`list_downloaded_files`

`get_download_directory`