mcp server

importly-mcp

MCP server for Importly — AI agents download & transcribe any video URL

yyildiz/importly-mcpcommunitylistedunreviewednot running here yet

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

Node.js 20 or newer

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "importly-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "importly-mcp"
      ],
      "env": {
        "IMPORTLY_API_KEY": "<your IMPORTLY_API_KEY>"
      }
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 14, 2026

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

Tool	What it does
`import_media` / `check_import`	Download media to hosted storage, get a direct link (optionally with a transcript)
`transcribe_media` / `check_transcription`	Speech-to-text with timestamped segments
`get_metadata` / `check_metadata`	Full metadata: formats, uploader, thumbnails, stats
`get_basic_metadata` / `check_basic_metadata`	Fast title/duration/thumbnail lookup
`check_balance`	Remaining credit balance

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

Setup

Get an API key at importly.io — $3.00 in free credits, no card required.
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.