Weaviate MCP server
Weaviate's built-in MCP server: hybrid vector and keyword search, schema inspection, and object upserts against a Weaviate vector database.
Weaviate ships an official MCP server built directly into the database engine, so as of Weaviate 1.37.1 there is no separate package to install: you enable it with the MCP_SERVER_ENABLED feature flag and it is served on the same port as the REST API at the /v1/mcp endpoint. That means an agent talks to exactly the same Weaviate instance you already run, and every call reuses Weaviate's existing API-key authentication and role-based access control rather than a parallel security model. The earlier standalone Go server in the weaviate/mcp-server-weaviate repository is deprecated in favor of this built-in implementation.
The server exposes a deliberately small set of tools for retrieval-augmented generation and memory use cases: inspect a collection's schema and vectorizer configuration, list tenants in a multi-tenant collection, run a hybrid query that fuses vector similarity with keyword (BM25) matching, and upsert objects to create or update stored data. Because hybrid search blends semantic and lexical signals, the agent can recall information by meaning while still honoring exact terms, making Weaviate a strong long-term memory and knowledge-retrieval backend that an agent can both read from and write to.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Add to ~/.claude.json
{
"mcpServers": {
"weaviate": {
"type": "http",
"url": "http://localhost:8080/v1/mcp",
"headers": {
"Authorization": "Bearer <WEAVIATE_API_KEY>"
}
}
}
}claude mcp add --transport http weaviate http://localhost:8080/v1/mcpAvailable tools
| Tool | Description |
|---|---|
| weaviate-collections-get-config | Inspects a collection's configuration, including its schema, properties, and vectorizer settings. |
| weaviate-tenants-list | Lists the tenants within a multi-tenant collection. |
| weaviate-query-hybrid | Runs a hybrid search that combines vector similarity with keyword (BM25) matching over a collection. |
| weaviate-objects-upsert | Creates or updates objects in a collection. |
Required configuration
- MCP_SERVER_ENABLEDRequired
Set to true on the Weaviate instance to enable the built-in MCP server at /v1/mcp. Required (server-side).
- WEAVIATE_API_KEYOptional
Weaviate API key sent as a bearer token; the server reuses Weaviate's existing API-key auth and RBAC.
What you can do with it
Hybrid retrieval for RAG
Let the agent run weaviate-query-hybrid so answers combine semantic vector similarity with exact keyword matches, improving recall over a knowledge base compared with pure vector search.
Read-write agent memory
Use weaviate-objects-upsert to persist notes and facts and the hybrid query tool to recall them, turning a Weaviate collection into durable, searchable agent memory.
FAQ
- Is it free?
- Yes. Weaviate is open source and self-hostable at no cost, and the built-in MCP server adds no extra charge. Weaviate Cloud is available as a managed option if you prefer not to self-host.
- Does it support remote/OAuth?
- It is a remote HTTP endpoint served by Weaviate itself at /v1/mcp on the same port as the REST API. It authenticates with Weaviate's existing API key (as a bearer token) and RBAC rather than a separate OAuth flow.