Chroma MCP

Chroma's server for creating collections and storing and querying documents in a Chroma vector database, local or cloud.

🗄️ Databases & vector stores599Updated 2025-09-17By chroma-coreLicense: Apache-2.0Auth: None for local useGitHub ↗

Found viaWebPyPI: chroma-mcp GitHubGitHub: chroma-core/chroma-mcp (★ 599 on 2026-10-15)

Test results

No full client pass yet

Claude CodeFailed2026-10-15 · connected, agent task (no successful call to this server's tools; no tool result containing ['TP-6A6774'])

CursorFailed2026-10-15 · connected, tools visible, agent task (no successful call to this server's tools; answer missing ['TP-36F9EB']; no tool result containing ['TP-36F9EB'])

Claude DesktopNot tested yet—

ChatGPT (Codex)Not tested yet—

Full result per app: Does it work with Claude Code? · Does it work with Cursor?

Protocol: failed · 2026-10-15 · server exited code 1

🧪 Test-box note: Published uvx snippet fails to start on Oct 15, 2026 (dependency break, see results/protocol). Tested as published; no pinning.

Install

claude mcp add chroma -- uvx chroma-mcp --client-type persistent --data-dir /path/to/dir/chroma

Run in your terminal. This exact command is what our harness runs in Claude Code; see the results above.

{
  "mcpServers": {
    "chroma": {
      "command": "uvx",
      "args": [
        "chroma-mcp",
        "--client-type",
        "persistent",
        "--data-dir",
        "/path/to/dir/chroma"
      ]
    }
  }
}

Save as .cursor/mcp.json. This exact config is what our harness runs in Cursor; see the results above.

{
  "mcpServers": {
    "chroma": {
      "command": "uvx",
      "args": [
        "chroma-mcp",
        "--client-type",
        "persistent",
        "--data-dir",
        "/path/to/dir/chroma"
      ]
    }
  }
}

Add to claude_desktop_config.json and restart Claude Desktop. Tested on the Linux beta; see the results above.

[mcp_servers.chroma]
command = "uvx"
args = ["chroma-mcp", "--client-type", "persistent", "--data-dir", "/path/to/dir/chroma"]

Add to ~/.codex/config.toml (shared by the ChatGPT (Codex) CLI and the ChatGPT desktop app; Codex runs inside the ChatGPT desktop app). Tested with the ChatGPT (Codex) CLI bundled in the ChatGPT desktop app; see the results above.

Not connecting? Troubleshooting: Claude Code · Cursor · Claude Desktop · ChatGPT (Codex)

Test history

Date	Check	Result	Version
2026-10-15	Protocol (direct stdio)	Protocol: failed
2026-10-15	Claude Code	Failed connected, agent task (no successful call to this server's tools; no tool result containing ['TP-6A6774'])	2.1.296 (Claude Code)
2026-10-15	Cursor	Failed connected, tools visible, agent task (no successful call to this server's tools; answer missing ['TP-36F9EB']; no tool result containing ['TP-36F9EB'])	2026.10.14-941492e