SponsorSubmit a toolSubscribe

Does Semble work with Claude Code?

Yes. Semble passed every step of our test in Claude Code on Oct 22, 2026: it installed, connected, its tools were visible, and an agent used it to finish a real task.

Result

ResultPassed
Date testedOct 22, 2026
Plan tested onClaude Pro
App versionClaude Code 2.1.296
Server packagesemble 0.7.0
Connect timeconnected in 2.7s
Modelhaiku

Steps

  1. install OK
  2. connect OK
  3. tools visible OK
  4. agent task: find definition OKsymbol lookup + one cross-file reference in a 2-file Python repo (git history has 1 commit, so git-only tools can answer via git_show)

From our own harness run, not the maker’s claims. How we test.

Versions tested

Claude Code 2.1.296 · semble 0.7.0 · connected in 2.7s · tested Oct 22, 2026

Server package tested: semble 0.7.0 (uv, Python 3.12.15; resolved 2026-10-22)

Direct and key dependencies as resolved: anyio 4.15.1 · mcp 2.3.0 · model2vec 0.10.0 · numpy 2.5.4 · orjson 3.13.0 · pathspec 1.1.1 · pydantic 2.14.1 · pydantic_core 2.50.1 · questionary 2.1.1 · semble-grammars 0.1.2 · sse-starlette 3.5.0 · starlette 1.9.0 · tqdm 4.70.1 · typing_extensions 4.16.0 · uvicorn 0.54.0 · vicinity 0.4.6

All 51 resolved dependencies
annotated-types==0.8.0
anyio==4.15.1
attrs==26.1.0
cffi==2.1.1
click==8.5.0
cloudpickle==3.1.2
cryptography==50.0.2
filelock==4.2.4
fsspec==2026.9.0
h11==0.16.0
hf-xet==1.7.0
httpcore2==2.16.0
httpx2==2.16.0
huggingface_hub==2.2.0
idna==3.20
Jinja2==3.1.6
joblib==1.6.0
jsonschema==4.26.0
jsonschema-specifications==2025.9.1
MarkupSafe==3.0.4
mcp==2.3.0
mcp-types==2.3.0
model2vec==0.10.0
numpy==2.5.4
opentelemetry-api==1.45.1
orjson==3.13.0
packaging==26.3
pathspec==1.1.1
prompt_toolkit==3.0.53
pycparser==3.12
pydantic==2.14.1
pydantic_core==2.50.1
PyJWT==2.15.1
python-multipart==0.0.32
PyYAML==6.0.3
questionary==2.1.1
referencing==0.37.0
rpds-py==2026.9.1
safetensors==0.8.0
semble-grammars==0.1.2
sse-starlette==3.5.0
starlette==1.9.0
tokenizers==0.23.3
tqdm==4.70.1
tree-sitter==0.26.0
truststore==0.10.5
typing-inspection==0.4.4
typing_extensions==4.16.0
uvicorn==0.54.0
vicinity==0.4.6
wcwidth==0.9.3

Captured with: uvx --from semble[mcp] python (importlib.metadata in the same uvx env; equivalent to uv pip freeze).

What happened in this run

Install config we used

claude mcp add -s local semble -- uvx --from semble[mcp] semble

Connection check

semble: uvx --from semble[mcp] semble - ✔ Connected

Tools check

verified via task step: agent saw and called the server's tools

Agent task: find definition

  • Tool calls, in order: mcp__semble__search

Raw details from our harness log for this run. Secrets redacted.

Set it up in Claude Code

Copy-paste config for every app is on the Semble page. Not connecting? Claude Code MCP troubleshooting.

Other apps we tested it in: Cursor (passed) · Claude Desktop (passed) · ChatGPT (Codex) (passed).

All MCP servers tested in Claude Code

Sponsors
+Sponsor this space