Threadctx MCP Server

by threadctx-devio.github.threadctx-dev/threadctx-mcpv0.5.0

Local-first shared team memory for coding agents: decisions, fixes and gotchas persist per repo and are shared across teammates' agents.

1Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained2mo ago

Install Threadctx MCP server

claude mcp add threadctx -e THREADCTX_API_KEY='<threadctx-api-key>' -- npx -y threadctx-mcp

{
  "mcpServers": {
    "threadctx": {
      "command": "npx",
      "args": [
        "-y",
        "threadctx-mcp"
      ],
      "env": {
        "THREADCTX_API_KEY": "<threadctx-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "threadctx": {
      "command": "npx",
      "args": [
        "-y",
        "threadctx-mcp"
      ],
      "env": {
        "THREADCTX_API_KEY": "<threadctx-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "threadctx": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "threadctx-mcp"
      ],
      "env": {
        "THREADCTX_API_KEY": "<threadctx-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "threadctx": {
      "command": "npx",
      "args": [
        "-y",
        "threadctx-mcp"
      ],
      "env": {
        "THREADCTX_API_KEY": "<threadctx-api-key>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
THREADCTX_MODE	—	—	'local' (default, free, no signup) or 'cloud' (shared team memory)
THREADCTX_API_KEY	—	yes	API key for cloud mode, issued at threadctx.dev. Not needed in local mode.

Freshness

Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-29 · 2mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-07-14 · 3mo ago · official registry · v0.5.0

FAQ

›How do I install the Threadctx MCP server in Claude Code?

Run: claude mcp add threadctx -e THREADCTX_API_KEY='<threadctx-api-key>' -- npx -y threadctx-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Threadctx require an API key?

Yes. It expects THREADCTX_API_KEY, of which 1 is a secret.

›Can I use Threadctx as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Threadctx in the official MCP registry?

Yes, as io.github.threadctx-dev/threadctx-mcp.