# Squish MCP server

> Converts continuous video into addressable visual and audio activity maps, allowing AI agents to navigate, zoom, and cite specific timestamps.

- Repository: https://github.com/getsquish/squish
- Page: https://hostedmcp.org/servers/getsquish/squish
- Transport: stdio, remote
- Stars: 2
- License: Apache-2.0
- Latest version: 0.3.1

## Install

### Claude Code

```sh
claude mcp add squish -- npx -y @getsquish/squish
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "squish": {
      "command": "npx",
      "args": [
        "-y",
        "@getsquish/squish"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "squish": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@getsquish/squish"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"squish","type":"stdio","command":"npx","args":["-y","@getsquish/squish"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "squish": {
      "command": "npx",
      "args": [
        "-y",
        "@getsquish/squish"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add squish -- npx -y @getsquish/squish
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.squish]
command = "npx"
args = ["-y", "@getsquish/squish"]
```

### Gemini CLI

```sh
gemini mcp add -s user squish npx -- -y @getsquish/squish
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "squish": {
      "command": "npx",
      "args": [
        "-y",
        "@getsquish/squish"
      ]
    }
  }
}
```

## FAQ

### How does Squish help AI agents interact with video?

Instead of watching a clip linearly, Squish creates an addressable map of frames and audio activity, allowing an agent to navigate, revisit, and zoom into specific time ranges.

### Does the audio activity include transcriptions or sound classification?

No, the audio band only shows energy levels (RMS-style energy envelope) and does not provide transcripts, sound classification, or emotion inference.

### Is my video data private when using the local MCP server?

Yes, the local MCP server processes everything on your machine and nothing is uploaded.

### Can I use Squish without installing it locally?

Yes, you can use the hosted connector in Claude Desktop or claude.ai by adding the provided URL, which processes public video URLs on Squish's server.
