Qdrant MCP Server: Setup for Claude, Cursor and Other Apps
Gives Claude, Cursor or another assistant a long-term memory: it saves notes in a Qdrant vector database and finds them again by meaning.
This is Qdrant's own server. It runs on your computer and talks to a Qdrant server you point it at, either Qdrant Cloud or one you host, or to a database folder on disk.
Set the address of your Qdrant server and, if it needs one, an API key. Also set a default collection name, so the assistant stays in one collection instead of choosing its own.
Good for
- People who want an assistant to remember facts between chats
- Developers who keep code snippets and want to search them by description
- Teams already running Qdrant who want an assistant to query it
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install mcp-server-qdrant
Claude Code
- 1
Copy this prompt.
Add the mcp-server-qdrant server to Claude Code. Run this command: claude mcp add qdrant -e QDRANT_URL=<QDRANT_URL> -- uvx mcp-server-qdrant Ask me for QDRANT_URL and only put the values in that config, nowhere else. Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires uv (Python).
Built from the package data we hold. Not yet tested by us.
Tools
Saves a note to Qdrant
Turns a piece of text into a vector, then saves it with optional metadata in a Qdrant collection. If the collection does not exist yet, the server creates it. Not available when read-only mode is on.
Try: “Remember that our staging database is rebuilt every Sunday night.”
Write ·
qdrant-storeSearches saved notes by meaning
Searches a collection by meaning, not exact words, and returns the closest saved entries with their metadata. Returns up to 10 results by default.
Try: “What did I save about the staging database?”
Network ·
qdrant-find
Read from the source code
Permissions
medium risk · 3 things to watch
Medium risk
It can save notes into Qdrant and read them back, and it creates a collection if the name does not exist. Set a default collection, and turn on read-only mode if the assistant should only search.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
Without a default collection it can write anywhere
If COLLECTION_NAME is not set, the assistant picks the collection on every call, and qdrant-store creates it when missing. Set COLLECTION_NAME, and use an API key limited to that collection if your Qdrant plan allows it. github.com
Anything saved is stored in plain text in Qdrant
Notes and metadata go into your Qdrant collection as given. Do not ask the assistant to remember passwords or other secrets. github.com
Over HTTP modes the server port is yours to protect
The default is stdio. If you pick sse or streamable-http, the README says it listens on 127.0.0.1 port 8000. Setting the host to 0.0.0.0, as the Docker example does, opens it to your whole network with no sign-in. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | Set QDRANT_READ_ONLY=true. The qdrant-store tool is then not registered, so only qdrant-find remains. |
|---|---|
| Talks to | The Qdrant server you configure (QDRANT_URL) |
| Sign-in and keys | The API key sits in the QDRANT_API_KEY environment variable in your client config. |
| Scopes |
|
Questions
Is the Qdrant MCP server official?
Yes. It lives in the qdrant GitHub organisation, and the README calls it an official Qdrant server.
What do I need to run it?
A Qdrant server and its URL, such as Qdrant Cloud or a self-hosted one. Add the API key if your server needs one. As an alternative to a URL you can point it at a local database folder.
Can I make it read-only?
Yes. Set QDRANT_READ_ONLY to true and the store tool is removed, leaving only search.
Is my data sent to a third party?
Your notes go to the Qdrant server you configure. The server turns text into vectors with a FastEmbed model, which is the only embedding option the README lists.
Which embedding model does it use?
sentence-transformers/all-MiniLM-L6-v2 by default. Set EMBEDDING_MODEL to change it. The README says only FastEmbed models are supported for now.
Can I use it as a code snippet search?
Yes. The README shows how to set custom tool descriptions so the assistant stores and finds code snippets, for use in Cursor or Windsurf.
Is it hosted or local?
Local. The server runs on your machine over stdio by default, and talks to your Qdrant database.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
mcp-server-qdrant- Registry
- PyPI
- Transport
- stdio, SSE, Streamable HTTP
- Auth
- API key
- License
- Apache-2.0
- Last commit
- Sep 4, 2026
- Open issues
- 31
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 4Hide
- README.md · github.com
- mcp_server.py · github.com
- settings.py · github.com
- qdrant.py · github.com