ChromaDB MCP Server
Connects AI agents to ChromaDB vector databases for semantic search and retrieval augmented generation (RAG) workflows. Supports creating collections, upserting documents with embeddings, querying by semantic similarity, and managing metadata filters. Ideal for knowledge base and document retrieval applications.
Connect
Add this configuration to .claude/mcp.json
{
"mcpServers": {
"chromadb": {
"command": "uvx",
"args": [
"chroma-mcp-server@latest"
],
"env": {
"CHROMA_HOST": "<YOUR_CHROMA_HOST>",
"CHROMA_PORT": "<YOUR_CHROMA_PORT>",
"CHROMA_AUTH_TOKEN": "<YOUR_CHROMA_AUTH_TOKEN>"
}
}
}
}Tools (4)
create_collection
Create a new ChromaDB collection with optional embedding function configuration.
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Collection name"
},
"metadata": {
"type": "object",
"description": "Optional collection metadata"
},
"embedding_function": {
"type": "string",
"description": "Embedding function to use (openai, cohere, sentence-transformers)"
}
}
}upsert_documents
Add or update documents in a collection with automatic embedding generation.
{
"type": "object",
"required": [
"collection",
"documents",
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Unique IDs for each document"
},
"documents": {
"type": "array",
"items": {
"type": "string"
},
"description": "Text documents to embed and store"
},
"metadatas": {
"type": "array",
"items": {
"type": "object"
},
"description": "Metadata for each document"
},
"collection": {
"type": "string",
"description": "Collection name"
}
}
}query
Query a collection by semantic similarity and return the most relevant documents.
{
"type": "object",
"required": [
"collection",
"query_text"
],
"properties": {
"where": {
"type": "object",
"description": "Metadata filter conditions"
},
"n_results": {
"type": "integer",
"description": "Number of results to return"
},
"collection": {
"type": "string",
"description": "Collection name"
},
"query_text": {
"type": "string",
"description": "Text to search for"
}
}
}list_collections
List all collections in the ChromaDB instance with their metadata and document counts.
{
"type": "object",
"properties": {}
}Resources
This server does not expose any resources.
Prompts
This server does not expose any prompts.
Server Information
- Author
- Chroma (@chroma-core)
- License
- Apache-2.0
- Version
- 0.6.2
- Stars
- 2,150
- Last Updated
- May 18, 2026