MCP Directory

How to add Qdrant MCP Server to Claude Desktop

Official Qdrant server using a vector collection as semantic memory: store and find embeddings. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 15, 2026 · 1.1k★ · stdio · apikey · official

Claude Desktop config for Qdrant MCP Server

uvx mcp-server-qdrant
{
  "mcpServers": {
    "qdrant-mcp-server": {
      "command": "uvx",
      "args": [
        "mcp-server-qdrant"
      ],
      "env": {
        "QDRANT_URL": "https://<your-cluster>.cloud.qdrant.io:6333",
        "QDRANT_API_KEY": "<your-api-key>",
        "COLLECTION_NAME": "<your-collection-name>",
        "EMBEDDING_MODEL": "sentence-transformers/all-MiniLM-L6-v2"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the Qdrant MCP Server config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm Qdrant MCP Server's tools appear under the 🔌 tools menu.

Before you start

  • Python with the `uv`/`uvx` package manager (or Docker as an alternative)
  • A Qdrant instance: a Qdrant Cloud cluster, a self-hosted server URL, or a local on-disk path via `QDRANT_LOCAL_PATH`
  • For remote Qdrant: a `QDRANT_API_KEY` (from your Qdrant Cloud dashboard at cloud.qdrant.io)
  • No separate embedding API key needed — embeddings default to the local FastEmbed model `sentence-transformers/all-MiniLM-L6-v2`

What Qdrant MCP Server can do in Claude Desktop

qdrant-store

Store a piece of information (with optional JSON metadata) into the Qdrant collection as an embedding

qdrant-find

Retrieve the most relevant stored entries for a natural-language query via semantic search

Security

For Qdrant Cloud the QDRANT_API_KEY grants full collection access, so keep it in env vars. The default embedding model downloads and runs locally on first use, which has compute and disk implications.

Qdrant MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Qdrant MCP Server config there under the "mcpServers" key and restart the client.

Is Qdrant MCP Server safe to use with Claude Desktop?

For Qdrant Cloud the QDRANT_API_KEY grants full collection access, so keep it in env vars. The default embedding model downloads and runs locally on first use, which has compute and disk implications.

Do I need an OpenAI or other embedding API key?

No. Embeddings are generated locally with FastEmbed (`all-MiniLM-L6-v2` by default), so the only credential you may need is a Qdrant API key for a remote cluster.

Can I run it without a Qdrant server?

Yes. Set `QDRANT_LOCAL_PATH` to a directory and it uses a local on-disk Qdrant database instead of a remote URL — but don't set both `QDRANT_URL` and `QDRANT_LOCAL_PATH`.

How do I make it read-only?

Set `QDRANT_READ_ONLY=true`, which disables the `qdrant-store` tool and exposes only `qdrant-find`.

View repo Full Qdrant MCP Server page