Skip to content
MCP server

Telys — on-device memory

Offline on-device memory and filtered vector search for AI assistants

Runs locallyStatus and history
Pricing
Freemium
Platforms
macOS, Linux, CLI
Runs
Locally
Version
0.1.15
Listing updated
3 days ago

About Telys — on-device memory

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

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.

Install

Run in a terminal

claude mcp add telys -- uvx telys

Add to claude_desktop_config.json

{
  "mcpServers": {
    "telys": {
      "command": "uvx",
      "args": [
        "telys"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "telys": {
      "command": "uvx",
      "args": [
        "telys"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $25 a month

Developer tier free; Pro $25/month or $250/year; Enterprise custom

Prices change. Check telys.ai before you buy.

Telys — on-device memory 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 to Telys — on-device memory

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  4. Local-first long-term memory layer for AI agents, served over MCP

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • 1.3K GitHub stars
    • Knowledge and memory
  5. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  6. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity