Log inSubmit server
Tisty logo

Tisty

Connects an assistant to local Markdown notes, documents, and tasks stored by Tisty on Windows or macOS.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Tisty

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "tisty": {
      "command": "npx",
      "args": [
        "-y",
        "tisty-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 1 tools correctly (1d ago).

Overview

Tisty is a local-first notes, document, and task manager that exposes its on-disk content to an assistant through MCP. It stores documents and task records as plain Markdown on the user's computer, including descriptions, journals, steps, attachments, and archived work. Use it when an assistant needs to read or update personal knowledge without sending data to a hosted service. Tisty is designed for individual use rather than team workspaces with permissions, assignees, or boards.

Use cases

  • Search past task journals and related documents
  • Record assistant-generated notes in local Markdown
  • Update tasks while preserving their working history
  • Build long-form documents with embedded technical material
  • Keep personal knowledge on a Windows or macOS computer

Key features

  • MCP access for reading and writing local content
  • Plain Markdown documents stored on disk
  • Tasks with descriptions, steps, journals, and attachments
  • Search across documents and task records
  • Windows and macOS desktop application
  • No account, subscription, telemetry, or hosted server

Tools1

What Tisty lets your agent do. Expand a tool for its parameters.

Verified live~50 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

9/9 checks healthy over the last 44d

What it can do

From the 1 tool this server returned when we ran it; 1 declare their own safety hints.

Read-only tools · 1
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age19 days
Maintainers1

Observed 2026-11-11 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · tisty-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars10Stargazers on the source repository.
npm downloads1.9kPackage downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed1Callable tools this server registers over MCP.

How Tisty works

What Tisty does

Tisty combines personal task tracking with a local Markdown writing environment. Documents can grow into longer material such as books, and may include diagrams, formulas, code, widgets, pictures, attachments, and PDFs. Tasks retain their working context instead of disappearing when completed: descriptions, steps, journal entries, related documents, and attachments remain available in the archive.

Its MCP connection lets an assistant work with this local information. The assistant can read and write notes, documents, and tasks, allowing the stored material to serve as searchable working context and a record of past decisions. The underlying files remain on the user's own disk rather than in a Tisty-hosted account or server.

How it works

Tisty is a desktop application for Windows and macOS. Its content is kept as plain Markdown and related local files, so the data can also be opened with ordinary editors and searched with command-line tools such as cat and grep. Search covers both documents and tasks, including completed work in the archive.

The application uses a Rust core inside a Tauri window. For users with two machines, Tisty can place larger attachments in a shared folder when the user chooses that arrangement. It does not require an account, subscription, or telemetry service.

MCP provides the assistant-facing access layer. This makes Tisty suitable for workflows where an assistant needs to consult existing notes or preserve the result of work in the same local knowledge base.

Setup and configuration

Tisty is available for Windows through the Microsoft Store and as a signed Windows installer. On macOS, it can be installed with Homebrew or downloaded as a signed disk image, with releases for each chip type. The project is open source and also provides its source code for users who want to build or run it themselves.

After installing the desktop application, keep the relevant notes, documents, and tasks in Tisty's local workspace. The MCP connection is intended for use with an assistant, but client-specific configuration details are not included here.

Tools and capabilities

  • Read and write local notes, documents, and tasks through MCP.
  • Search documents together with task records.
  • Preserve task descriptions, steps, journals, attachments, and related documents after completion.
  • Work with Markdown documents containing diagrams, formulas, code, widgets, pictures, and PDFs.
  • Keep data on the user's own disk without an account or hosted server.

Limitations and notes

Tisty is built for one person. It has no assignees, permissions, or team boards, so it is not intended to manage collaborative team workflows. Its local-first design also means that synchronizing between machines depends on a shared folder or another user-selected method rather than a Tisty-hosted service. The project is licensed under AGPL-3.0.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Tisty

Tisty is an MCP server that connects an assistant to local Tisty notes, Markdown documents, and tasks on Windows or macOS. Its main capabilities are reading and writing those records, including task descriptions, steps, journals, attachments, and archived work, while keeping the underlying data on the user's own disk.

Install Tisty on Windows or macOS first. Windows users can use the Microsoft Store or a signed installer, while macOS users can use Homebrew or a signed disk image. The application then provides the local notes, documents, and tasks used through MCP.

No, Tisty stores its notes, documents, and tasks on your own disk. It does not require an account or subscription and does not use a Tisty-hosted server or telemetry service.

No, Tisty is designed for one person. It does not provide assignees, permissions, or boards, so it is not intended for shared team task management.

Related MCP servers

All in Knowledge & Memory All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewTisty AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/tisty?style=directory)](https://allmcps.com/mcp/tisty)
HTML Embed
<a href="https://allmcps.com/mcp/tisty"><img src="https://allmcps.com/api/badge/tisty?style=directory" alt="Tisty on AllMCPs" /></a>