Skip to content
MCP server

Tisty

Local notes, tasks and documents as Markdown that an AI agent can search and reuse

Runs locallyStatus and history
Pricing
Open source
Platforms
Windows, macOS, CLI
Runs
Locally
Version
1.47.1
Listing updated
3 days ago

About Tisty

Tisty is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add tisty -- npx -y tisty-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tisty": {
      "command": "npx",
      "args": [
        "-y",
        "tisty-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tisty": {
      "command": "npx",
      "args": [
        "-y",
        "tisty-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

What it does

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

Pricing

Open source

Free; AGPL-3.0-only

Prices change. Check tisty.app before you buy.

Tisty 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 to Tisty

  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. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  4. 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
  5. 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
  6. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools