Chroma MCP Server
Chroma MCP servers enable AI models to interact with the Chroma embedding database for vector search, collection management, and document operations.
Overview
The Chroma MCP Server connects AI models to Chroma, the open-source embedding database for building Python or JavaScript LLM apps with memory. It provides standardized tools to create and manage collections, add/query documents via vector search and full-text search, and filter by metadata.
Created by:
Developed by Chroma
Key Features
Flexible Client Types
Ephemeral, persistent (file-based), HTTP for self-hosted, and Cloud client
Collection Management
Create, modify, delete; list with pagination; HNSW configuration
Document Operations
Add, query, get, update, delete; metadata filtering and full text search
Embedding Functions
Supports default, Cohere, OpenAI, Jina, VoyageAI, Roboflow; persists per-collection
Available Tools
Quick Reference
| Tool | Purpose | Category |
|---|---|---|
chroma_list_collections | List collections with pagination | Discovery |
chroma_create_collection | Create a new collection | Schema |
chroma_modify_collection | Update name or metadata | Schema |
chroma_delete_collection | Delete a collection | Schema |
chroma_add_documents | Insert documents with metadata/IDs | Write |
chroma_query_documents | Semantic query with filters | Read |
chroma_get_documents | Retrieve by IDs/filters | Read |
chroma_update_documents | Update content/metadata/embeddings | Write |
chroma_delete_documents | Remove documents | Write |
Detailed Usage
chroma_list_collections▶
List all collections with optional pagination parameters.
use_mcp_tool({
server_name: "chroma",
tool_name: "chroma_list_collections",
arguments: {
offset: 0,
limit: 20
}
});
chroma_create_collection▶
Create a collection with optional metadata and HNSW configuration.
use_mcp_tool({
server_name: "chroma",
tool_name: "chroma_create_collection",
arguments: {
name: "my_collection",
metadata: { project: "docs" },
hnsw: { m: 16, efConstruction: 200 }
}
});
chroma_add_documents▶
Add documents with optional metadata and custom IDs.
use_mcp_tool({
server_name: "chroma",
tool_name: "chroma_add_documents",
arguments: {
collection: "my_collection",
ids: ["doc-1", "doc-2"],
documents: [
"First document text",
"Second document text"
],
metadatas: [
{ source: "notes" },
{ source: "manual" }
]
}
});
chroma_query_documents▶
Query documents using semantic search with advanced metadata filtering.
use_mcp_tool({
server_name: "chroma",
tool_name: "chroma_query_documents",
arguments: {
collection: "my_collection",
query_texts: ["pagination implementation"],
n_results: 5,
where: { source: "manual" }
}
});
chroma_get_documents▶
Retrieve documents by IDs or metadata filters with pagination.
use_mcp_tool({
server_name: "chroma",
tool_name: "chroma_get_documents",
arguments: {
collection: "my_collection",
ids: ["doc-1"],
offset: 0,
limit: 10
}
});
Installation
{
"mcpServers": {
"chroma": {
"command": "uvx",
"args": [
"chroma-mcp",
"--client-type",
"ephemeral"
]
}
}
}
Persistent / Cloud / HTTP:
Configure clients via arguments:
Persistent: "args": ["chroma-mcp", "--client-type", "persistent", "--data-dir", "/path/to/data"]
Cloud: "args": ["chroma-mcp", "--client-type", "cloud", "--tenant", "your-tenant", "--database", "your-db", "--api-key", "your-api-key"]
HTTP: "args": ["chroma-mcp", "--client-type", "http", "--host", "your-host", "--port", "your-port", "--custom-auth-credentials", "your-credentials", "--ssl", "true"]
Embedding Function API Keys:
When using external embedding providers (Cohere, OpenAI, Jina, VoyageAI, Roboflow), set the corresponding API key environment variables per provider. Embedding function persistence requires Chroma v1.0.0+.
For secure local setup, pass --dotenv-path to load keys from a custom .env file.
Example: "args": ["chroma-mcp", "--dotenv-path", "/custom/path/.env"]
Sources
Related Articles
Analytics & Data MCP Servers: AI Integration & Insights
Explore MCP servers for analytics and data processing, providing standardized interfaces for AI models to interact with analytics platforms and data visualization tools.
Moralis MCP Server
Moralis MCP servers enable AI models to query on-chain data — wallet activity, token metrics, NFTs, and dapp usage — via the Moralis Web3 APIs.
ClickUp MCP Server
ClickUp MCP servers enable AI models to interact with ClickUp workspaces, providing capabilities for task management, project tracking, time tracking, and team collaboration workflows.