English Français العربية

io.importly/importly-mcp

Official registry Media and design

Download, transcribe, and get metadata for any video/audio URL. Managed yt-dlp + speech-to-text.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package importly-mcp
Claude Code 
claude mcp add importly-mcp -e 'IMPORTLY_API_KEY=<your importly_api_key>' -- npx -y importly-mcp@0.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "importly-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "importly-mcp@0.1.0"
            ],
            "env": {
                "IMPORTLY_API_KEY": "<your importly_api_key>"
            }
        }
    }
}

Environment variables

  • IMPORTLY_API_KEY required secret Importly API key — free key with $3 credits at https://importly.io/?utm_source=mcp&utm_medium=integration&utm_campaign=official-registry

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Importly MCP Server
  2. Tools
  3. Setup
  4. Example prompts
  5. Pricing
  6. Docs & support

Importly MCP Server

Give your AI agent the ability to download, transcribe, and inspect any video or audio URL — YouTube, TikTok, X, podcasts, and 1000+ other sites.

Importly runs yt-dlp, rotating residential proxies, ffmpeg, and speech-to-text server-side, so your agent (and you) never deal with IP bans, 429s, cookie rot, or extractor breakage.

Tools

ToolWhat it does
import_media / check_importDownload media to hosted storage, get a direct link (optionally with a transcript)
transcribe_media / check_transcriptionSpeech-to-text with timestamped segments
get_metadata / check_metadataFull metadata: formats, uploader, thumbnails, stats
get_basic_metadata / check_basic_metadataFast title/duration/thumbnail lookup
check_balanceRemaining credit balance

Jobs are async: submit tools return a jobId, check tools poll it. Responses tell the agent exactly what to do next.

Setup

  1. Get an API key at importly.io — $3.00 in free credits, no card required.
  2. Add the server to your MCP client:
Claude Code
claude mcp add importly -e IMPORTLY_API_KEY=your_key -- npx -y importly-mcp
Claude Desktop / Cursor / Cline / Windsurf
{
  "mcpServers": {
    "importly": {
      "command": "npx",
      "args": ["-y", "importly-mcp"],
      "env": { "IMPORTLY_API_KEY": "your_key" }
    }
  }
}

(Claude Desktop: claude_desktop_config.json · Cursor: .cursor/mcp.json · Cline: MCP settings UI · Windsurf: ~/.codeium/windsurf/mcp_config.json)

Example prompts

  • "Transcribe this talk and summarize the key points: https://www.youtube.com/watch?v=…";
  • "Download the audio of this podcast episode and give me a link"
  • "How long is this video and who uploaded it?"

Pricing

Usage-based credits (downloads ~$0.01/MB, transcription per media minute) — see pricing. New accounts get $3.00 free.

Docs & support

MIT licensed. The server is a thin wrapper over the Importly API.

Frequently asked questions

What is io.importly/importly-mcp?

Download, transcribe, and get metadata for any video/audio URL. Managed yt-dlp + speech-to-text.

How do I install io.importly/importly-mcp?

It runs on your machine. In Claude Code: claude mcp add importly-mcp -e 'IMPORTLY_API_KEY=<your importly_api_key>' -- npx -y importly-mcp@0.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.importly/importly-mcp need an API key?

Yes. It expects IMPORTLY_API_KEY, which you set in its configuration.

Is io.importly/importly-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.importly/importly-mcp?

It is published by yyildiz. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.