How to add Qdrant MCP Server to Cursor

Official Qdrant server using a vector collection as semantic memory: store and find embeddings. Paste the config into ~/.cursor/mcp.json and restart Cursor.

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

Cursor 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

1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the Qdrant MCP Server config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of Qdrant MCP Server's tools to confirm it's connected.

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 Cursor

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 + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Qdrant MCP Server config there under the "mcpServers" key and restart the client.

Is Qdrant MCP Server safe to use with Cursor?

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