Set up Weaviate MCP in Claude Code

Connect to Weaviate vector database collections for semantic search, knowledge base operations, and chat memory storage from your AI editor.

Locate the config file

Claude Code reads MCP server configuration from the following file:

~/.claude.json

Create this file if it does not already exist.

Add the configuration

You can configure Weaviate MCP using the CLI command or by editing the config file directly.

Option A: CLI command

bash

claude mcp add weaviate-mcp -e WEAVIATE_URL=YOUR_WEAVIATE_URL -e WEAVIATE_API_KEY=YOUR_WEAVIATE_API_KEY -- npx -y mcp-server-weaviate

Option B: Config file

json

{
  "mcpServers": {
    "weaviate-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-weaviate"
      ],
      "env": {
        "WEAVIATE_URL": "YOUR_WEAVIATE_URL",
        "WEAVIATE_API_KEY": "YOUR_WEAVIATE_API_KEY"
      }
    }
  }
}

Set up environment variables

Weaviate MCP requires the following environment variables:

WEAVIATE_URLRequired

Weaviate instance URL

WEAVIATE_API_KEYOptional

Weaviate API key for authentication

Verify it works

Restart Claude Code. Weaviate MCP should appear in your MCP server list with 11 tools available.

This server adds approximately 5,665 tokens to your context window for tool definitions.

Set up Weaviate MCP in other editors

Cursor VS Code Windsurf Claude Desktop Continue

← Back to Weaviate MCP