# Chroma

Chroma gives an agent a vector store: collections, semantic search, metadata filters. Useful when context needs to persist across sessions.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: chroma-core
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/chroma-core/chroma-mcp
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/chroma

## What it does

Chroma hooks an open-source embedding database into your agent. The model creates collections from generated data and user input, then pulls from them with vector search, full text search, or metadata filters.

The server exposes tools like `chroma_create_collection`, `chroma_add_documents`, `chroma_query_documents`, `chroma_get_documents`, `chroma_update_documents`, and `chroma_delete_documents`, plus a few for collection management. You can run it in-memory for tests, on disk for persistence, over HTTP against a self-hosted instance, or in cloud mode that connects to `api.trychroma.com`.

Embedding functions that call external APIs (cohere, openai, jina, voyageai, roboflow) require an API key in an environment variable. The exact format depends on the provider. One catch: embedding function persistence arrived in Chroma 1.0.0, so collections made on version 0.6.3 or older do not support it. Launch the server with `uvx chroma-mcp`.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- give an agent memory between sessions
- find documents by meaning instead of exact word match
- filter query results by metadata
- store data locally with no external service
- update and remove documents from collections

## Example prompts
- Create a collection called notes and add these entries with date metadata
- Search the docs collection for pages similar to "setting up CI"
- How many documents are in the emails collection right now?

## Similar
- [rag-chroma](https://affpapa.org/en/nevibecode/skills/rag-chroma.md) — skill · 68 installs
- [vector-database-management](https://affpapa.org/en/nevibecode/skills/vector-database-management.md) — skill · 460 installs
- [similarity-search-patterns](https://affpapa.org/en/nevibecode/skills/similarity-search-patterns.md) — skill · 10700 installs
- [rag-implementation](https://affpapa.org/en/nevibecode/skills/sickn33-rag-implementation.md) — skill · ★ 50109 repo stars
- [upstash-vector-js](https://affpapa.org/en/nevibecode/skills/upstash-vector-js.md) — skill · 1500 installs
- [rag-engineer](https://affpapa.org/en/nevibecode/skills/sickn33-rag-engineer.md) — skill · 1000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
