Thread Mind MCP Server

Branches for your AI's memory: a git-friendly tree of thread summaries. ThreadMind is a Model Context Protocol (MCP) server that gives AI coding sessions a memory: a tree of threads, each holding a short summary of what was decided about one topic, stored as Markdown in your repository. Start a fresh session and the active thread's context - its decisions and those of its ancestors - replaces a history that had…. Its 14 documented tools cover thread, project, switch.

People who work with thread, project and switch and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-27 · ★ 3 · #133 OF 321 MAINTAINED MEMORY · VERIFIED 2026-09-30

MIT · TypeScript servers · how we verify → /methodology

01 · Install Thread Mind

before you install - you'll need

THREADMIND_ROOT

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add mahmoud-nb-thread-mind-mcp -- npx -y thread-mind-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "mahmoud-nb-thread-mind-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "thread-mind-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package thread-mind-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.mahmoud-nb is GitHub-verified and matches the repo owner

03 · What Thread Mind can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can create a new project with a root "main" thread, list all projects (shows the session's project), create a child thread, and delete a thread and all its descendants.

Capability map

Tools grouped from the project's README - what Thread Mind lets an agent do.

Thread

7 tools - e.g. Create a child thread; on a feature branch, link it to the branch; Switch this session to a different thread and return its assembled context; Display the thread tree, with statuses and linked branches

thread_create · thread_switch · thread_list · thread_status · thread_merge · thread_delete…

Project

3 tools - e.g. Create a new project with a root "main" thread; List all projects (shows the session's project); Switch the session to a different project (a single project is selected automatically)

project_create · project_list · project_switch

Summary

1 tool - e.g. Update the summary of a thread, or one of its sections

summary_update

Context

1 tool - e.g. Get the assembled context with token estimation

context_get

Threadmind

1 tool - e.g. Generate instruction files for agents that don't read MCP server instructions (AGENTS.md, etc.)

threadmind_init

Stats

1 tool - e.g. Show summary sizes and, with the Claude Code plugin, measured conversation sizes

stats_show

04 · Who maintains Thread Mind

thread-mind is maintained by mahmoud-nb. It's the only MCP server we track from this author; the repo dates to Apr 2026.

05 · Facts

repository: github.com/mahmoud-nb/thread-mind-mcp
category: memory - ranked #133 of 321 actively-maintained memory servers as of 2026-09-30.
registry: io.github.mahmoud-nb/thread-mind (active, first published 2026-09-27)
packages: npm:thread-mind-mcp

06 · Thread Mind FAQ

Is Thread Mind still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-27. We re-verify nightly.

What can Thread Mind do?

How do I install Thread Mind?

Run `npx -y thread-mind-mcp`. The README documents one environment variable (THREADMIND_ROOT) to set first. You can also paste the ready-made client config above.

Does Thread Mind run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Thread Mind

Alternatives to Thread Mind

Maintained memory servers if Thread Mind isn't the fit.

Pairs well with

Servers that cover what Thread Mind doesn't - only shown when the pairing reason fits the companion.

More memory MCP servers · Pensyve · Memorylens MCP · Mars Nme · Mushroomdb · Smart Memory

More TypeScript MCP servers · Marmo UI · Mailtrap · Mako · Einvoice · Advanced Zebrunner MCP Server · see all