# Tisty MCP server

> Lets AI agents manage local tasks, documents, and notes in Markdown to maintain long-term memory and context.

- Repository: https://github.com/rgdevment/Tisty
- Page: https://hostedmcp.org/servers/rgdevment/tisty
- Transport: stdio
- Stars: 10
- License: AGPL-3.0
- Latest version: 1.47.1

## Install

### Claude Code

```sh
claude mcp add tisty -- npx -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"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"tisty","type":"stdio","command":"npx","args":["-y","tisty-mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

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

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.tisty]
command = "npx"
args = ["-y", "tisty-mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user tisty npx -- -y tisty-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## FAQ

### What is Tisty?

Tisty is a local-first productivity tool for notes, documents, and tasks that provides a memory layer for both users and AI agents.

### How does Tisty help my AI agent?

It allows agents to pick up where they left off by reading outlines and specific sections instead of entire files, saving tokens and context.

### Is my data private?

Yes, Tisty is 100% local with no accounts, no subscriptions, no telemetry, and no cloud server.

### What file format does Tisty use?

Tisty uses plain Markdown files stored on your own disk.
