@keepgoingdev/mcp-server

MCP server for KeepGoing.dev - a momentum companion for developers. KeepGoing helps you keep going on projects when you return after time away.

KeepGoing auto-captures checkpoints (what you were doing, what's next, which files matter) on git commits, branch switches, and inactivity. When you start a new session, your AI assistant reads your last checkpoint instead of re-inferring everything from scratch. Local-first, no account required.

Quick Setup

The easiest way to get started is with the installer, which installs the CLI globally and runs the setup wizard:

curl -fsSL https://keepgoing.dev/install.sh | bash

For a specific tool:

curl -fsSL https://keepgoing.dev/install.sh | bash -s -- claude
curl -fsSL https://keepgoing.dev/install.sh | bash -s -- vscode

Claude Code (manual)

Global (recommended) — works across all your projects:

claude mcp add keepgoing --scope user -- npx -y @keepgoingdev/mcp-server

Per-project — scoped to a single project:

claude mcp add keepgoing --scope project -- npx -y @keepgoingdev/mcp-server

Then run keepgoing setup claude to configure hooks and rules.

Cursor, Windsurf, and other tools

Add to your MCP config file (~/.cursor/mcp.json for Cursor, or the equivalent for your tool):

{
  "mcpServers": {
    "keepgoing": {
      "command": "npx",
      "args": ["-y", "@keepgoingdev/mcp-server"]
    }
  }
}

Tools

Core

| Tool | Description | |------|-------------| | get_momentum | Get your last checkpoint, next step, blockers, and branch context. Quick snapshot of where you left off. Accepts optional tier and model params for token-aware output. | | get_reentry_briefing | Get a synthesized re-entry briefing with focus, recent activity, and suggested next steps. Accepts optional tier and model params for token-aware briefing tiers. | | get_session_history | Get recent session checkpoints in chronological order. Supports branch filtering and configurable limit. | | get_whats_hot | See recently active files and branches across sessions. | | continue_on | Export your development context as a formatted prompt for another AI tool (chatgpt, gemini, copilot, claude, general). | | save_checkpoint | Save a development checkpoint after completing a task or meaningful piece of work. |

Paid Add-ons

| Tool | Add-on | Description | |------|--------|-------------| | get_decisions | Decision Detection | Get recent high-signal commits with their category, confidence, and rationale. | | get_current_task | Session Awareness | Get current live session tasks across multiple concurrent AI agent sessions. | | activate_license | | Activate a KeepGoing license on this device. | | deactivate_license | | Deactivate the KeepGoing license on this device. |

How It Works

Add this MCP server to your AI coding assistant (Claude Code, Cursor, Windsurf, etc.)
Start coding. Use save_checkpoint from your AI assistant to capture what you did, what's next, and any blockers
Come back anytime. Your AI assistant calls get_momentum or get_reentry_briefing to pick up exactly where you left off
Optionally, install the KeepGoing VS Code extension for automatic checkpoint capture on inactivity, git commits, and branch switches — no manual saves needed

All data is stored locally in a .keepgoing/ directory at your git root.

Requirements

Node.js 18+
The KeepGoing VS Code extension is optional — useful for auto-capturing checkpoints on git commits, branch switches, and inactivity, but the MCP server works standalone via save_checkpoint

License

MIT

mcp-server