SSyncDev

OmniGet MCP Server

A desktop downloader and toolbox that coding agents can drive locally: queue media, read files, check ports.

Local server

What is the OmniGet MCP Server?

Here is a scenario OmniGet handles well: you hand an agent twelve links, ask it to download them all as audio, and want a report on which failed and why. The OmniGet MCP server makes that a single request, because the agent talks to a full desktop downloader rather than shelling out to scripts.

OmniGet is a free, open-source desktop app for Windows, macOS and Linux. Its MCP server runs inside the app and listens on 127.0.0.1:47720, so nothing works unless OmniGet itself is open.

What an agent can reach

The tool surface is broad and grouped by area:

Area Examples
Downloads queue links, list formats, pause, retry, read the failure diagnosis
Sites and courses drive the built-in browser, read a page within a token budget, download a course in order
Files and media convert formats, read finished files, search a book library
Developer utilities folder to one prompt-ready file, page to Markdown, HTTP requests, ports, JSON, JWT, hashes, regex, FTP and SFTP
Chats and feeds read and reply in linked chats using your own session
System scan for junk and plan a cleanup

Long results are trimmed and saved to a file, and errors name the next step.

Under the hood the downloader covers YouTube, Instagram, TikTok, X, Reddit, Vimeo and every site yt-dlp supports, plus galleries, torrents, magnet links, HLS streams and Telegram chats. Its helper programs install and update themselves.

Getting connected

The quickest route: open OmniGet, then ask your agent to run curl -s "http://127.0.0.1:47720/connect" and follow the steps. OmniGet pops up with the requesting tool's name and a short code; you check it and click Allow. It then writes the server entry and a private token into that tool's config.

For manual setup, create a connection under Settings > AI & agents > Connect to other apps > More options to get a token. HTTP-capable clients such as Claude Code and Cursor point at /mcp with a Bearer header. Stdio-only clients like Claude Desktop use the bundled omniget-mcp bridge.

Control and caveats

Each connection gets its own token and only the permissions you tick. New connections, cleanups and anything that posts or sends wait for a click in the OmniGet window; an agent cannot approve its own request. Cookies and keys are never returned to the agent.

Some practical notes. OmniGet ships without a paid code-signing certificate, so first launch may trigger SmartScreen or Gatekeeper warnings. If the port is busy, OmniGet tries 47721 to 47729. And downloading is limited to what your own session can open: it does not bypass DRM or paywalls, and copyright is your responsibility.

Looking for other app bridges? See our other integrations list, which collects servers that, like OmniGet's MCP server, wrap a desktop application. The wider integrations directory is updated as new ones are approved.

How to install the OmniGet MCP Server

{
  "mcpServers": {
    "omniget": {
      "command": "omniget-mcp",
      "env": {
        "OMNIGET_MCP_URL": "http://127.0.0.1:47720/mcp",
        "OMNIGET_MCP_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Uses the omniget-mcp stdio bridge that ships with every release. OmniGet must be running. Get the token from Settings > AI & agents > Connect to other apps > More options.

Configuration

VariableDescriptionRequired
OMNIGET_MCP_TOKENPrivate connection token created in OmniGet's settings; sent as a Bearer token or passed to the omniget-mcp bridge.Yes
OMNIGET_MCP_URLAddress of the running app's MCP endpoint for the omniget-mcp stdio bridge, normally http://127.0.0.1:47720/mcp.Optional

Frequently asked questions

Yes. The server runs inside the desktop app on 127.0.0.1. If the app is closed you get an APP_NOT_RUNNING error; open OmniGet and keep the server enabled under Settings > AI & agents.