mediasense

Name: mediasense
Author: joaoestella

by joaoestellaversion 0.5.1i★ –iRuns on your computer

Registry nameio.github.joaoestella/mediasense

Install

Overview

Description from the maker (original English)

Let Claude listen to audio and watch video: transcribe, summarize and edit recordings and links.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiVery new↓ 309/wk · ★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Design, images & audio

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: MEDIASENSE_COOKIES_FROM_BROWSER

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "mediasense": {
      "command": "uvx",
      "args": [
        "mediasense",
        "mcp"
      ],
      "env": {
        "MEDIASENSE_COOKIES_FROM_BROWSER": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add mediasense --env MEDIASENSE_COOKIES_FROM_BROWSER=your-value -- uvx mediasense mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "mediasense": {
      "command": "uvx",
      "args": [
        "mediasense",
        "mcp"
      ],
      "env": {
        "MEDIASENSE_COOKIES_FROM_BROWSER": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "mediasense": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mediasense",
        "mcp"
      ],
      "env": {
        "MEDIASENSE_COOKIES_FROM_BROWSER": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

MEDIASENSE_COOKIES_FROM_BROWSER env
Optional: browser to read cookies from (chrome, firefox, edge…) for links that need a login.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account joaoestella, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Design, images & audioi

More stars than 0% of the other 2787 servers in this category
Published to the registry more recently than 96% of the other 2787 servers in this category
Basic checks equal to or better than 100% of the other 2787 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is mediasense safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.5.1) reached the registry yesterday.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Figma Context MCP, Claude Real Video, Figma MCP Server

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Figma Context MCP

Give your coding agent access to your Figma data. Implement designs in any framework in one-shot.

by GLipsWidely used↓ 161.2K/wk★ 16.2KUpdated 5 months ago

Runs on your computer

Install

Claude Real Video

Let any LLM watch a video locally — and search everything it has ever watched.

by HUANGCHIHHUNGLeoWidely used↓ 1.1K/wk★ 2.3KUpdated 2 months ago

Runs on your computer

Install

Figma MCP Server

Figma’s official server gives AI your design data so it can turn designs into code or describe them accurately. Connects to Figma’s cloud.

by figmaGrowing★ 2.2KUpdated 13 months ago

Runs in the cloud✓ mcp.figma.com

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

mediasense

Give Claude ears and eyes. Claude can't listen to audio or watch videos on its own; with mediasense it can. Point at a voice message, podcast, recording or meeting, or paste a TikTok, YouTube or Instagram link, in Claude Code or Claude Desktop and ask in plain language. Claude can then transcribe it, summarize it, explain what happens, find the moment something is said, or edit it.

you: what does this voice message say? ~/Downloads/audio-from-maria.opus

you: summarize this https://www.tiktok.com/@someone/video/7350… you: what does he show at 0:30? and what tool is he talking about? you: clean up ~/Desktop/podcast.m4a — remove the "um"s and long pauses you: make short captions for ~/Videos/reel.mp4 you: put intro.mp3 under the first 5 seconds of talk.mp4, ducked

Real output for a 17-second TikTok by @elim.doc, shown with the creator's permission. Regenerate the animation with python docs/make_demo.py.

mediasense runs on your computer: it downloads the link, transcribes speech in ~99 languages with a timestamp for every word, picks key frames at scene changes, and hands Claude a transcript, a shot list and contact-sheet images. Nothing is uploaded anywhere.

Português 🇧🇷

Setup

Windows – paste in PowerShell:

irm https://raw.githubusercontent.com/joaoestella/mediasense/main/install.ps1 | iex

macOS / Linux – paste in a terminal:

curl -LsSf https://raw.githubusercontent.com/joaoestella/mediasense/main/install.sh | sh

Then quit Claude Desktop completely (tray/menu-bar icon → Quit), open it again and ask *"summarize this video: "*. The first transcription downloads the speech model (≈ 500 MB).

Prefer to read the script before running it?

irm https://raw.githubusercontent.com/joaoestella/mediasense/main/install.ps1 -OutFile install.ps1

notepad install.ps1 powershell -ExecutionPolicy Bypass -File .\install.ps1

(macOS/Linux: curl -LsSfO …/install.sh, read it, then sh install.sh.)

The installer only installs what is missing — Python 3.12 and FFmpeg via winget (Homebrew/apt on macOS/Linux) and pipx via pip — then pipx installs mediasense from this repository and runs mediasense setup. It stops at the first failed step.

Manual setup (no script)

winget install ffmpeg                    # macOS: brew install ffmpeg · Linux: sudo apt install ffmpeg

python -m pip install --user pipx python -m pipx ensurepath # then close and reopen the terminal python -m pipx install "mediasense[all]" mediasense setup -n # preview what setup will change mediasense setup mediasense doctor

Use python -m pipx … rather than plain pipx right after installing it: the pipx command only appears on PATH in a new terminal. No Git needed.

As a Claude plugin (skill + server in one)

The repository is also a Claude plugin: installing it adds both the mediasense tools and the skill that tells Claude when to use them. It starts the server with uv, so install uv first (winget install astral-sh.uv · brew install uv · curl -LsSf https://astral.sh/uv/install.sh | sh) plus FFmpeg if you don't have it.

In Claude Code:

/plugin install mediasense --marketplace joaoestella/mediasense

Any other MCP client (Cursor, VS Code, Windsurf…)

mediasense is a standard stdio MCP server, also listed in the official MCP Registry as io.github.joaoestella/mediasense:

{ "mcpServers": { "mediasense": { "command": "uvx", "args": ["mediasense", "mcp"] } } }

Or with a normal install: pipx install mediasense, then use mediasense mcp as the command.

One-click Claude Desktop extension (experimental)

Download [mediasense.mcpb](https://github.com/joaoestella/mediasense/releases/latest/download/mediasense.mcpb) and double-click it (or drag it into Claude Desktop → Settings → Extensions). No Python, pipx or FFmpeg needed: Claude Desktop sets up Python by itself, and FFmpeg is downloaded on first use. The first start takes a few minutes while it installs everything. This uses Claude Desktop's new "UV" extension type, so if it doesn't work on your version, use the installer above.

What `mediasense setup` changes

Claude Desktop: adds one entry, mcpServers.mediasense, to claude_desktop_config.json (%APPDATA%\Claude\ – or %LOCALAPPDATA%\Claude-Data\claude_…\ for the Microsoft Store app – ~/Library/Application Support/Claude/ on macOS, ~/.config/Claude/ on Linux; Claude Desktop → Settings → Developer → Edit Config opens the one your app uses). Everything else in the file is kept, and the previous file is saved next to it as claude_desktop_config.json. .bak. If the file isn't valid JSON, setup stops without touching it.
Claude Code (if installed): runs claude mcp add --scope user mediasense -- \mediasense mcp.
Nothing else. mediasense setup -n shows the exact changes without making them; --desktop or --code limits it to one app. To undo: remove the mediasense entry from the config file and run claude mcp remove mediasense --scope user.

Updating on Windows and pipx says a file "is being used by another process"? Claude Desktop is still running the old server: Get-Process mediasense | Stop-Process -Force, then install again (the installer script does this for you).

Something not working? mediasense doctor checks FFmpeg, the speech model, the GPU, link downloads and the Claude connection.

Teach Claude when to use it (recommended)

mediasense comes with a skill: a short guide that makes Claude reach for mediasense whenever you paste a video link, instead of trying to open the page (TikTok & co. block that).

Claude Code: installed automatically by mediasense setup.
Claude Desktop / claude.ai: download mediasense-skill.zip (the installer also saves it to Downloads/mediasense/), then in Claude open Settings → Skills and upload it. One time only; it syncs to all your devices.

Note: Claude Desktop sends files you attach in the chat to the model, not to your computer, so give

mediasense a link or a file path instead (in Claude Code you can drag the file into the terminal).

Slash commands

The server adds ready-made prompts. In Claude Code they appear as /mcp__mediasense__summarize and so on.

Prompt	Does
`summarize`	gist, key points with timestamps, steps, names and links, call to action
`explain_video`	shot-by-shot explanation, plus how the video is built (hook, structure)
`clean_up`	remove fillers and long pauses, show the plan first, render after your OK
`subtitles`	SRT captions, standard or short 1–3-word style for vertical video

Tools Claude gets

Tool	What it does
`understand_media`	one call: download link, transcribe, key frames + speech per shot, post title/description
`transcribe`	speech → `.transcript.json` with word timestamps; `vocabulary` fixes brand names
`read_transcript`, `search_transcript`	read a time range or find every time a phrase is said
`plan_edit`, `render_edit`	cut phrases, passages, fillers, silences or ranges; preview, then render
`export_transcript`	SRT, VTT, TXT, CSV, JSON
`place_audio`	insert a clip at a timestamp (mix / duck / replace)
`watch_video`, `get_frame`	contact sheets, or one frame at a given time
`media_info`	duration, resolution, fps, streams
`check_job`	result of long work: new videos and the first run reply "still working" and finish in the background

Long work never hits Claude's tool time limit: if a video takes more than ~30 s (a long video on a CPU, or the very first run while the speech model downloads), the tool answers "still working" with a progress percentage and Claude checks back with check_job until it's done.

All tools accept a file path or a link. Links are downloaded once to ~/Downloads/mediasense (change with MEDIASENSE_HOME) and reused.

Command line

Everything also works without Claude:

mediasense understand "https://youtu.be/…"           # transcript + shots + metadata, as text

mediasense transcribe talk.mp4 -l pt --vocab "Cloudflare, Claude" --also srt mediasense search talk.transcript.json "next quarter" mediasense edit talk.mp4 --fillers --silences 0.7 -n # -n = only show the plan mediasense edit talk.mp4 --fillers --silences 0.7 --srt --edl --fcpxml mediasense edit talk.mp4 --cut-between "let me check" "okay so" --cut-range 12:03-12:40 mediasense export talk.transcript.json captions.srt --words-per-cue 2 mediasense place video.mp4 voiceover.wav --at 0:12.5 --mode duck mediasense storyboard reel.mp4 mediasense fetch "https://www.tiktok.com/@…/video/…"

Edits never touch the original: results are written as .edited.* / .placed.*. EDL opens in Premiere, Resolve and Avid; FCPXML in Final Cut Pro and Resolve.

Good to know

Names and jargon. Whisper may write "Cloud Fair" for Cloudflare. Pass --vocab (Claude does this automatically when it can infer the names from the title or the screen).
Fillers. Whisper tends to leave hesitations out; transcribe with --verbatim when you want to cut them. Real words are protected per language ("um" is an article in Portuguese, so it is never cut there). Ambiguous words like "like", "tipo" or "né" are only removed if you list them.
Speed. Everything works on a plain CPU: short clips take seconds, a few minutes of audio takes about as long as the audio with the default small model (base is faster, medium more accurate). No GPU? --backend openai sends the audio to an OpenAI-compatible transcription API instead (fast on any machine, but the audio leaves your computer).
NVIDIA GPU (optional, much faster). mediasense uses it automatically once the CUDA libraries are present; no CUDA toolkit needed:

  python -m pipx inject mediasense nvidia-cublas-cu12 "nvidia-cudnn-cu12>=9,<10" nvidia-cuda-runtime-cu12

(≈ 1.5 GB; needs a driver that supports CUDA 12 – mediasense doctor checks both). Restart Claude Desktop afterwards.

Word timing is approximate (0.1–0.2 s). For tighter cuts and speaker labels use --backend whisperx (pip install "mediasense[whisperx]").
Downloading from links follows each site's terms. Use it for content you're allowed to download.

Privacy Policy

mediasense runs entirely on your computer: no accounts, no analytics, no telemetry, and the author receives no data. It connects to the internet only to download the links you ask about, the speech model (first run), FFmpeg if it's missing, and – only if you choose the openai backend – to send audio to the transcription API you configure. Results stay on your disk until you delete them. When used from Claude, tool results (transcripts, key frames, metadata) are returned to the Clau

Only the beginning is shown; read the rest in the repo

mediasense

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Design, images & audioi

Common questions

Alternatives

Figma Context MCP

Claude Real Video

Figma MCP Server

README from the maker

mediasense

Setup

What mediasense setup changes

Teach Claude when to use it (recommended)

Slash commands

Tools Claude gets

Command line

Good to know

Privacy Policy

What `mediasense setup` changes