Does Semble work with Claude Desktop?
Yes. Semble passed every step of our test in Claude Desktop on Oct 22, 2026: it installed, connected, its tools were visible, and an agent used it to finish a real task.
Result
Steps
- install OK
- connect OK
- tools visible OK
- 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)
Test note: server wrapped in harness/scripts/mcp_tee.py to record JSON-RPC; prompts typed via xdotool; tool Allow pop-ups approved by the operator for test servers only; model = app default
From our own harness run, not the maker’s claims. How we test.
Versions tested
Claude Desktop 2.37337.1 (Linux beta, Electron 44.7.0) · semble 0.7.0 · connected in 2.8s · 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.3Captured 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
{
"command": "uvx",
"args": [
"--from",
"semble[mcp]",
"semble"
]
}Connection check
initialize seen in tee log after app restartTools check
tools/list answered (tee log)
Agent task: find definition
- 2 calls reached the server
- Agent’s answer (excerpt):
Defined in: billing.py; Called from: utils.py (inside format_receipt, which calls compute_total(prices, 0.08))
Raw details from our harness log for this run. Secrets redacted.
Set it up in Claude Desktop
Copy-paste config for every app is on the Semble page. Not connecting? Claude Desktop MCP troubleshooting.
Other apps we tested it in: Claude Code (passed) · Cursor (passed) · ChatGPT (Codex) (passed).