# Semlith

> Semlith is a freemium MCP server for developer tools. Local code and document search for AI agents, with an optional paid cloud index. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** macOS, Linux, Windows, CLI, self-hosted
- **Website:** https://semlith.com
- **Repository:** https://github.com/semlith/semlith
- **MCP Registry name:** io.github.semlith/semlith
- **Categories:** developer tools, knowledge and memory
- **Listing updated:** 2026-11-14

## About

Semlith builds one index across source code, PDFs, Office files, notebooks and images, then answers agent queries with the few passages that matter instead of whole files. Each query runs a vector search and a keyword search and fuses the rankings, so a question about retry backoff and an exact identifier both land on the right chunk.

Alongside the text index it keeps a code graph of definitions, calls, imports and re-exports. Agents can ask what calls a function or what a change would reach, and the answers are graph facts rather than model output; the site says no generative model sits in the retrieval path. A watcher re-reads a file on save, so there is no build step to go stale.

The local binary listens only on 127.0.0.1 and needs no account or API keys. An --airgap flag refuses every outbound request, and credential files such as .env and ~/.ssh are skipped unless you pass --include-secrets. Semlith Cloud is a separate hosted service that adds a remote MCP URL, GitHub, GitLab, Confluence and Jira sources, and a pull-request impact check.

## Features

- **Hybrid search:** Fuses vector and keyword rankings so both natural-language questions and exact names find the right chunk.
- **Code graph:** Maps calls, imports and re-exports across repositories so agents can ask what uses a symbol or what a change reaches.
- **Retrieval ledger:** Records every retrieval in a chained log, with the tokens it saved.
- **Pull request impact check:** On Cloud plans, posts a status check and comment listing the callers a pull request reaches.
- **Airgap mode:** Refuses every outbound request before a connection opens.
- **Many file types:** Reads 46 languages, 13 document formats and images.

## Good for

- Give a coding agent the exact files and spans for a question in a large repository
- Search PDFs, Office documents and notes alongside code
- Check which callers a change reaches before merging
- Share one index between several agents and machines through Cloud
- Keep code search fully offline on a restricted machine

## Install

### Claude Code (Terminal)

```sh
claude mcp add semlith -- npx -y semlith
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "semlith": {
      "command": "npx",
      "args": [
        "-y",
        "semlith"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "semlith": {
      "command": "npx",
      "args": [
        "-y",
        "semlith"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "semlith": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "semlith"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "semlith": {
      "command": "npx",
      "args": [
        "-y",
        "semlith"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "semlith": {
      "command": "npx",
      "args": [
        "-y",
        "semlith"
      ]
    }
  }
}
```

## FAQ

### Does it need an account or API key?

No. The local binary needs neither; signing in is only for Semlith Cloud, a separate hosted service.

### Is it free?

The local binary is free with every feature. Cloud has Pro, Team and Enterprise plans, each paid plan with a 14-day trial; prices are not published on the page.

### Which platforms does it run on?

macOS on Apple silicon, Linux on x86_64 or aarch64, and Windows on x86_64. Intel macOS is not supported.

### How many MCP tools does it expose?

The README says eight tools are listed by default and sixteen exist in total.

### What does Cloud add?

A remote MCP URL, GitHub, GitLab, Confluence, Jira and upload sources, CI tokens and the pull-request impact check.

### Is Semlith free?

Semlith has a free plan, with paid plans for more usage or features.

### How do I add Semlith to Claude Code?

Run this command in your terminal: claude mcp add semlith -- npx -y semlith

### What are the best alternatives to Semlith?

The closest alternatives to Semlith are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/semlith
