At a glance
- Availability: Experimental (how to enable).
- Authentication: API key.
- Connection: The key comes from
WEAVIATE_API_KEY. - Provider documentation: Authentication reference.
Credentials
Set these per environment. See Connect an integration.Setup
- Create a Weaviate Cloud account: Sign up at https://console.weaviate.cloud. Free 14-day sandbox clusters are available for testing. Self-hosted Weaviate with API-key auth enabled works too.
- Create a cluster and grab credentials: Create a cluster, then open Cluster details to copy the REST endpoint URL and an API key (use a read-write key for object creation). The key is only displayed once.
- Store the key and note your host: Add WEAVIATE_API_KEY=… to your .env file. Tools take the cluster host (without https://) as the WEAVIATE_CLUSTER_HOST environment variable, e.g. my-cluster-abc123.weaviate.cloud.
- Verify access: With WEAVIATE_CLUSTER_HOST configured, run the Get Schema tool.
Provider notes
- Every tool needs the WEAVIATE_CLUSTER_HOST environment variable; there is no global Weaviate API host
- nearText GraphQL queries require a vectorizer module configured on the collection (and possibly a model-provider API key set on the cluster)
- Admin keys can read and write; read-only keys will get 403 on Create Object
Tools
Verify the connection
Call a read tool such asweaviate__get_schema with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.