Qdrant MCP Server for Claude Desktop: Setup & Config

What you can do with Qdrant in Claude Desktop

A focused official Qdrant memory layer with customizable tools for semantic recall and snippet reuse.

• Store facts that an assistant can retrieve later.
• Find reusable code snippets from natural-language descriptions.

Before you start: Qdrant in Claude Desktop

• uv / uvx
• A Qdrant server or a configured local Qdrant database path

stdio is the default. For local mode, replace QDRANT_URL with QDRANT_LOCAL_PATH. The README also documents --transport sse and --transport streamable-http; database and model settings use environment variables.

Qdrant Claude Desktop configuration

1. Choose Claude Desktop configuration scope

   For Qdrant MCP Server, open macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json. Merge under mcpServers via Settings → Developer → Edit Config when available.

2. Add Qdrant MCP Server to Claude Desktop

   Use the mcp-server-qdrant entry below in mcpServers. Keep Qdrant MCP Server's documented stdio connection fields and your other Claude Desktop entries.

3. Check Qdrant MCP Server in Claude Desktop

   Qdrant MCP Server: Fully quit and reopen Claude Desktop; check developer diagnostics.

{
  "mcpServers": {
    "mcp-server-qdrant": {
      "command": "uvx",
      "args": [
        "mcp-server-qdrant"
      ],
      "env": {
        "QDRANT_URL": "<Qdrant server URL; omit when using a local path>",
        "QDRANT_API_KEY": "<API key if required by the Qdrant server>",
        "COLLECTION_NAME": "<Default memory collection>",
        "EMBEDDING_MODEL": "<FastEmbed model; default sentence-transformers/all-MiniLM-L6-v2>"
      }
    }
  }
}

Qdrant tools available to Claude Desktop

Qdrant's stored tool list documents 2 tools; compare it with Claude Desktop's connected tool list, because the stored list is not a live check.

qdrant-store

When Claude Desktop requests qdrant-store from Qdrant, review the action before approving it.

Save information with optional JSON metadata in a Qdrant collection.

qdrant-find

When Claude Desktop requests qdrant-find from Qdrant, review the action before approving it.

Qdrant: full stored tool descriptions

Troubleshooting Qdrant in Claude Desktop

• Fully quit and reopen Claude Desktop for Qdrant MCP Server. If uvx mcp-server-qdrant (from uv, for Python tools) is missing, check the desktop process's PATH, which may differ from your terminal.
• In Claude Desktop's Qdrant MCP Server entry, check COLLECTION_NAME, EMBEDDING_MODEL, QDRANT_API_KEY, QDRANT_URL. Keep secrets out of shared screenshots and repositories.
• Qdrant MCP Server uses stdio here: Claude Desktop must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Only FastEmbed models are currently supported.
• Known limitation: A database URL and local path cannot be configured together.
• Known limitation: The documented tools focus on memory rather than database administration.
• General Claude Desktop troubleshooting lives in the /clients/claude-desktop guide.

Frequently asked questions