BuckyMedia
Let your AI agent queue the download.
BuckyMediaMCP is a small MCP server that sits between an AI agent and the BuckyMedia desktop app. Ask your agent to grab a video, and it talks to BuckyMedia for you.
What you need
- Windows.
- BuckyMedia installed and running (it can stay minimized in the system tray).
- In BuckyMedia's Settings, "Commands for AI agents (Beta)" turned on. It's off by default — an intentional, opt-in security choice — so this step can't be skipped, or every tool will fail with a "could not reach BuckyMedia" error even while BuckyMedia is running.
- Claude Desktop installed, if that's the agent you plan to use.
Download and run the installer
BuckyMediaMCP ships as a single Windows installer, built with Velopack — no cloning, no dependencies, no manual JSON editing.
- 1 Download the Installer of the MCP.
- 2 Run the installer.
- 3 Use with your favorite AI agent.
The installer registers BuckyMediaMCP as an MCP server directly in Claude Desktop's configuration for you. Restart Claude Desktop once after installing so it picks up the new server. Uninstalling BuckyMediaMCP removes that entry again automatically.
Straight from the source
BuckyMediaMCP will also be submitted to the official connector catalogs of AI apps like Claude Desktop, so it can eventually be found and installed from inside those apps directly, with no installer download at all.
Tools exposed to your agent
One tool per command BuckyMedia's AI-agent pipe supports. Claude discovers all of them automatically once the server is connected.
| Tool | What it does |
|---|---|
| wake_buckymedia | Brings the BuckyMedia window to the foreground. |
| analyze_video | Analyzes a video URL and returns its title, duration, thumbnail, and the real qualities, formats, subtitles and audio tracks available. |
| download_video | Queues a download and returns a task ID. Supports clip trimming and a custom destination folder. |
| play_video | Plays a video URL directly in BuckyMedia's built-in player, optionally in mini-player mode, fullscreen, or at a set screen position. |
| set_player_mode | Switches the open player between normal and mini (picture-in-picture) mode. |
| set_fullscreen | Turns fullscreen on or off for the open player. |
| set_player_position | Moves the open player window to a screen position, clamped to the current monitor. |
| pause_download | Pauses one download, or all of them. |
| resume_download | Resumes a paused download. |
| cancel_download | Cancels one download, or all of them. |
| get_download_status | Returns the current download queue, with progress, speed, size and status. |
| open_catalog | Opens or focuses BuckyMedia's media catalog window. |
| open_catalog_search | Opens the catalog window with search results for a title, for you to pick from. |
| search_movie | Searches installed catalog addons for a title and returns results with no UI shown. |
If no default download folder is set in BuckyMedia's Settings, queuing a download opens a native "Save As" dialog that needs a quick human click — so a download_video call can take a moment to return. Setting a default folder in BuckyMedia avoids that.
Wire it up in a few minutes
Completely free — the same rule as everything else BuckyMedia ships.