Skip to main content
Add Mixpeek to Claude Desktop or Claude Code and let Claude search your media directly.

​
Prerequisites

​
Setup

1

Add to Claude config

Add the Mixpeek MCP server to your Claude configuration. The retrieval-scoped server gives Claude access to your search pipelines, agents, and documents.
Open claude_desktop_config.json and add the mixpeek-retrieval server:
{
  "mcpServers": {
    "mixpeek-retrieval": {
      "url": "https://mcp.mixpeek.com/retrieval/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
Replace YOUR_API_KEY with your key from the Mixpeek dashboard.
2

Verify the connection

Restart Claude (Desktop: quit and reopen, Code: restart the session). Then ask:
What Mixpeek tools do you have access to?
Claude lists the available tools (e.g. execute_retriever, list_retrievers, search_namespace). If it does not, check your config path and API key.
3

Search your data

With the connection verified, ask Claude to query your media. Here is an example conversation searching video content:
You: Search my training-videos retriever for clips where someone
     demonstrates a deadlift.

Claude: [calls execute_retriever with query="deadlift demonstration"]
        I found 4 matching clips:
        1. "Proper Deadlift Form" (02:14–02:48) — score 0.94
        2. "Full Body Workout Day 3" (18:30–19:15) — score 0.87
        3. "Common Lifting Mistakes" (05:02–05:38) — score 0.82
        4. "Beginner Barbell Guide" (11:20–12:01) — score 0.79

You: Summarize what the top result covers.

Claude: [calls execute_retriever for document details]
        The clip walks through the setup, grip width, hip hinge
        mechanics, and lockout position for a conventional deadlift.
        The instructor flags two common errors: rounding the lower
        back and pulling with the arms.

​
Available Scopes

Pick the server scope that matches your workflow. Narrower scopes use fewer tokens and reduce tool clutter.
ScopeURLToolsUse case
Fullhttps://mcp.mixpeek.com/mcp43All capabilities — ingestion, retrieval, and admin
Ingestionhttps://mcp.mixpeek.com/ingestion/mcp18Buckets, collections, and documents
Retrievalhttps://mcp.mixpeek.com/retrieval/mcp11Retrievers, agents, and search
Adminhttps://mcp.mixpeek.com/admin/mcp14Namespaces, taxonomies, and clusters
Start with the retrieval scope. Add ingestion or admin only if Claude needs to create resources or manage your namespace.

​
Per-Retriever Server

If you want Claude to access a single retriever with a typed search tool (parameters generated from your retriever’s input schema), use the mixpeek-mcp-retriever CLI: 
pip install mixpeek
Then add it to your Claude Desktop config: 
{
  "mcpServers": {
    "my-search": {
      "command": "mixpeek-mcp-retriever",
      "args": [
        "--retriever-id", "ret_abc123",
        "--namespace-id", "ns_xyz789",
        "--api-key", "YOUR_API_KEY"
      ]
    }
  }
}
This exposes three tools: search (with typed parameters matching your retriever’s input schema), describe, and explain. See the full MCP reference for HTTP transport and environment variable configuration.

​
Next Steps