> For the complete documentation index, see [llms.txt](https://docs.telys.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telys.ai/mcp/client-cursor-vscode.md).

# Cursor & VS Code

Add the Telys MCP server to Cursor or VS Code so the editor's AI agent can search and write on-device memory while you work.

Cursor and VS Code both speak MCP over stdio, so the same `telys mcp` server drops into either — only the config file and its shape differ. `telys mcp install` configures Cursor; configure VS Code by hand.

{% tabs %}
{% tab title="Cursor" icon="laptop-code" %}
Cursor reads MCP servers from `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` inside a project (project scope).

Let the installer write it:

```bash
telys mcp install --client cursor                 # user scope (~/.cursor/mcp.json)
telys mcp install --client cursor --scope project # this repo (./.cursor/mcp.json)
```

Or add the block yourself. Set `TELYS_MEMORY_PATH` only for a store other than `~/.telys/memory`:

{% code title=".cursor/mcp.json" lineNumbers="true" %}

```json
{
  "mcpServers": {
    "telys": {
      "command": "telys",
      "args": ["mcp"],
      "env": {
        "TELYS_MEMORY_PATH": "/Users/you/.telys/memory"
      }
    }
  }
}
```

{% endcode %}

Reload from **Settings → MCP** (or restart Cursor). The `telys` server appears with its 19 tools.
{% endtab %}

{% tab title="VS Code" icon="code" %}
VS Code uses a different key and requires an explicit transport `type`. Put it in `.vscode/mcp.json` for a workspace, using the `servers` object with `"type": "stdio"`:

{% code title=".vscode/mcp.json" lineNumbers="true" %}

```json
{
  "servers": {
    "telys": {
      "type": "stdio",
      "command": "telys",
      "args": ["mcp"],
      "env": {
        "TELYS_MEMORY_PATH": "/Users/you/.telys/memory"
      }
    }
  }
}
```

{% endcode %}

The installer does not target VS Code, so add this file yourself. Save it, then start the server from the **Start** action VS Code shows above the entry, or reload the window. The tools become available to the agent in the Chat view.
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
If the editor launches from a desktop icon it may not inherit your shell's `PATH`, so a bare `"command": "telys"` can fail. Run `which telys` and set `command` to that absolute path (a pipx install is typically `/Users/you/.local/bin/telys`).
{% endhint %}

## Reload after editing

Both editors read the config when the MCP server starts. After any change, reload — Cursor from **Settings → MCP**, VS Code with the **Start**/**Restart** action on the entry (or **Developer: Reload Window**) — so the editor respawns `telys mcp`.

## What you will see

The `telys` server appears in the editor's MCP panel with 19 tools — search and query, CRUD, collection admin, maintenance, and a repo auto-indexer (full list in the [MCP overview](https://docs.telys.ai/mcp/overview.md#the-tools-at-a-glance)). Drive it from the agent in natural language:

```
Use telys_search on the collection "project-notes" for "auth token refresh" and summarize the hits.
```

The agent calls `telys_search` and summarizes the returned hits — ids, similarity scores, and metadata. If the collection does not exist yet, ask the agent to add a few notes first — `telys_add` creates it on the fly.

{% hint style="info" %}
No results or a missing server usually means the runtime is not verified or the `command` path is wrong. Run `telys runtime verify` and see [MCP client won't connect](https://docs.telys.ai/troubleshooting/mcp-client.md).
{% endhint %}

## Next steps

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Other MCP clients</strong></td><td>Codex and any stdio client.</td><td><a href="https://docs.telys.ai/mcp/client-other.md">Other clients</a></td></tr><tr><td><strong>Tool: telys_search</strong></td><td>Every argument the search tool takes.</td><td><a href="https://docs.telys.ai/mcp/tool-search.md">telys_search</a></td></tr><tr><td><strong>Configuration &#x26; scoping</strong></td><td>Per-project memory with project scope.</td><td><a href="https://docs.telys.ai/mcp/configuration-and-scoping.md">Config &amp; scoping</a></td></tr></tbody></table>
