# Tisty

> Tisty is an open-source MCP server for knowledge and memory. Local notes, tasks and documents as Markdown that an AI agent can search and reuse. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, macOS, CLI
- **Website:** https://www.tisty.app
- **Repository:** https://github.com/rgdevment/tisty
- **MCP Registry name:** io.github.rgdevment/tisty
- **Categories:** knowledge and memory, productivity
- **Listing updated:** 2026-11-14

## About

Tisty is a desktop app first, and its MCP server (the tisty-mcp npm package, run over stdio) is how an agent reaches the same data. Everything lives as Markdown on your disk, so any editor can open it and nothing is sent to a Tisty account, because there is none.

The pitch is continuity: a finished task moves to an archive with its steps and journal, and a later search by you or the agent brings it back whole. Documents are split by subject, so the agent reads the outline first and then only the section it needs; the site claims about 97 percent less reading than a 256 KB notes file. Diagrams are kept as Mermaid text, and quick capture turns phrases like "call the bank at 3" into dated tasks.

A companion called Folio shares a document as an encrypted, signed link that opens in any browser without an account. Tisty is AGPL-3.0, has no telemetry, and runs on Windows 10 or later and macOS 13.3 or later.

## Features

- **Archive keeps the why:** Finished tasks stay searchable with their steps and journal.
- **Outline-first documents:** Agents read the outline and only the needed section.
- **Mermaid diagrams:** Diagrams are stored as plain text inside Markdown.
- **Quick capture:** Natural phrases become tasks with dates; Tab makes a short idea note.
- **Eisenhower matrix:** Tasks are sorted by urgency and importance.
- **Folio sharing:** Send a document as an encrypted, signed link readable without an account.

## Good for

- Give a coding agent project memory across sessions
- Recall how a past bug was fixed
- Keep decision records an agent can quote
- Hand over context between roles with an encrypted link

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## FAQ

### Where is my data stored?

On your computer as Markdown, optionally synced through Google Drive, OneDrive, WebDAV or a chosen folder.

### Does it cost anything?

No. The pricing page says every feature is free, with no account, telemetry or ads.

### What licence is it?

AGPL-3.0-only.

### Which platforms?

Windows 10 (1809) or later and macOS 13.3 or later.

### Is Tisty free?

Yes. Tisty is open source, so you can use and self-host it for free.

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

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

### What are the best alternatives to Tisty?

The closest alternatives to Tisty are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

## 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.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [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.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

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