videoseek-mcp

Find anything in any video. Semantic video search, video Q&A, persistent memory, and social media import — all as MCP tools for your AI agent.

What can it do?

Give your AI agent (Claude, Cursor, Windsurf, etc.) the ability to:

Search videos by meaning — "find the moment where someone opens the gift" across your entire library
Ask questions about videos — multi-turn conversations with one video or your whole collection
Remember everything — persistent text + video memory that never forgets (Memory Augmented Generation)
Import from social media — pull and index content from TikTok, YouTube, Instagram, and 15+ platforms
Analyze on-the-fly — describe any video or image from URL without uploading
Transcribe — get visual scene descriptions or spoken word transcripts

Quick Start

1. Get an API Key

2. Install

git clone https://github.com/kennyzheng-builds/videoseek-mcp.git
cd videoseek-mcp
npm install --include=dev
npm run build

3. Connect to your AI client

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "videoseek": {
      "command": "node",
      "args": ["/path/to/videoseek-mcp/build/index.js"],
      "env": {
        "MEMORIES_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "videoseek": {
      "command": "node",
      "args": ["/path/to/videoseek-mcp/build/index.js"],
      "env": {
        "MEMORIES_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

export MEMORIES_API_KEY="your-api-key"
claude mcp add videoseek -- node /path/to/videoseek-mcp/build/index.js

Tools (18)

Video Management

| Tool | What it does | |------|-------------| | upload_video | Upload and index a video from URL | | list_videos | List all indexed videos | | get_video_status | Check processing status | | delete_videos | Remove videos from your library | | get_transcription | Get visual or audio transcription |

Search

| Tool | What it does | |------|-------------| | search_videos | Semantic search across your private video library | | search_public | Search TikTok, YouTube, Instagram by meaning | | search_audio | Find when something was said in a video |

Video Q&A

| Tool | What it does | |------|-------------| | chat_with_video | Ask questions about specific videos (multi-turn) | | chat_personal | Ask questions across your entire library + memories |

Persistent Memory

| Tool | What it does | |------|-------------| | add_memory | Store text with semantic indexing | | search_memories | Find relevant memories by meaning | | list_memories | List all stored memories |

Vision Analysis

| Tool | What it does | |------|-------------| | caption_video | Analyze a video from URL (no upload needed) | | caption_image | Analyze an image from URL |

Social Media Import

| Tool | What it does | |------|-------------| | import_from_url | Import from any social media URL | | import_by_hashtag | Import by hashtag from TikTok/YouTube/Instagram | | import_by_creator | Import from a creator's profile |

Resources & Prompts

Resources: memories://videos (your library), memories://memories (your stored knowledge)

Prompt templates: analyze-video, social-media-research, build-knowledge-base

Example Conversations

"Find a moment"

You: Find all moments where someone is cooking pasta

Agent uses search_videos → returns timestamped video segments

"Understand a video"

You: What's happening in this video? [URL]

Agent uses caption_video → instant analysis without uploading

"Research TikTok"

You: Research AI trends on TikTok

Agent uses search_public → import_from_url → chat_personal for insights

"Build knowledge"

You: Summarize all my meeting recordings

Agent uses list_videos → get_transcription → add_memory for key takeaways

How It Compares

| Feature | videoseek-mcp | TwelveLabs MCP | |---------|--------------|----------------| | Persistent memory (text + video) | Yes | No | | Social media import (15+ platforms) | Yes | No | | Memory Augmented Generation | Yes | No | | Free tier | 100 credits/month | 10 hours | | Multi-video Q&A | Yes | Yes | | Semantic search | Yes | Yes |

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | MEMORIES_API_KEY | Yes | — | API key from memories.ai | | MEMORIES_UNIQUE_ID | No | "default" | Namespace for multi-tenant isolation |

Development

npm install --include=dev
npm run build          # compile TypeScript
npm run dev            # watch mode
npx @modelcontextprotocol/inspector node build/index.js   # test interactively

Architecture

videoseek-mcp/
├── src/
│   ├── index.ts     # MCP server — 18 tools, 2 resources, 3 prompts
│   └── client.ts    # Video understanding API client
├── build/           # Compiled JS (generated)
├── package.json
└── tsconfig.json

TypeScript + Zod schemas + stdio transport. No dependencies beyond MCP SDK.

License

MIT

MCP Servers