# Telys — on-device memory

> Telys — on-device memory is a freemium MCP server for knowledge and memory. Offline on-device memory and filtered vector search for AI assistants. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $25 a month
- **Platforms:** macOS, Linux, CLI, self-hosted
- **Website:** https://telys.ai
- **Repository:** https://github.com/thyn-ai/telys-sdk
- **MCP Registry name:** io.github.thyn-ai/telys
- **Categories:** knowledge and memory, databases
- **Listing updated:** 2026-11-14

## About

Queries stay inside your own process. After a one-time `telys login` that issues a signed device license and runtime, the engine runs fully offline and does not contact the network at query time. The runtime and license are verified locally against public keys, and the vendor says remembering is never metered, with no per-query or per-token fee on any tier.

Its distinguishing idea is that time is part of the data model: memories have validity windows, supersession chains and provenance, and `as_of()` lets you ask what an agent knew at a given moment. A query on a partition key resolves to one contiguous scan with an explain plan; off-key filters fall back to a slower path and the plan says so. The vendor reports 0.013 ms p50 for filtered top-10 over a million vectors, a figure it publishes with conditions.

The MCP server, `telys mcp`, runs over stdio with 19 tools, including search, add, collection management and a repo auto-indexer, and `telys mcp install` configures Claude, Cursor and Codex. The SDK is Apache-2.0; the runtime is a separately distributed signed binary for macOS arm64 and Linux, with Windows via WSL2.

## Features

- **Offline retrieval:** No network round trip at query time after sign-in.
- **Time-aware memory:** Validity windows, supersession and `as_of()` time travel.
- **Filtered search:** Partition-key queries use one contiguous scan with an explain plan.
- **Vector and lexical:** Combines semantic and text search over a collection.
- **19 MCP tools:** Memory CRUD, search, compaction, tuning and a repo indexer.
- **One-command setup:** `telys mcp install` writes entries for Claude, Cursor and Codex.

## Good for

- Give a coding assistant private memory that works offline
- Ask an agent what it knew last month
- Keep per-tenant memories isolated by partition key
- Index a repository for scoped code retrieval
- Run agent memory on a machine with no network access

## Install

### Claude Code (Terminal)

```sh
claude mcp add telys -- uvx telys
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "telys": {
      "command": "uvx",
      "args": [
        "telys"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "telys": {
      "command": "uvx",
      "args": [
        "telys"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "telys": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "telys"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "telys": {
      "command": "uvx",
      "args": [
        "telys"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "telys": {
      "command": "uvx",
      "args": [
        "telys"
      ]
    }
  }
}
```

## Tools

- `telys_search`: Semantic and lexical search over a memory collection.
- `telys_add`: Adds text documents, creating the collection if needed.
- `telys_create_collection`: Creates a collection with a fixed name and partition key.
- `telys_list_collections`: Lists collections.

## FAQ

### Does it send my data to the cloud?

The vendor says queries never touch the network and nothing phones home at query time.

### What does it cost?

The Developer tier is free for one developer; Pro is $25 a month or $250 a year, and Enterprise is custom.

### Which platforms are supported?

macOS arm64 and Linux x86_64 or arm64; Windows runs under WSL2.

### Do I need to sign in?

Yes, a one-time free `telys login` is needed to execute memory tools.

### Is Telys — on-device memory free?

Telys — on-device memory has a free plan, with paid plans for more usage or features. Paid plans start at $25 a month.

### How do I add Telys — on-device memory to Claude Code?

Run this command in your terminal: claude mcp add telys -- uvx telys

### What are the best alternatives to Telys — on-device memory?

The closest alternatives to Telys — on-device memory are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and Midplane.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [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.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/telys-on-device-memory
