@keepgoingdev/mcp-server

MCP server for KeepGoing.dev that gives AI coding assistants persistent project memory.

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 context instead of re-inferring everything from scratch. Local-first, no account required.

Quick Setup

Claude Code

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 ask Claude Code to run setup_project (with scope: "user" for global, or default for per-project) to add session hooks and CLAUDE.md instructions.

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"]
    }
  }
}

Manual config

Add to your MCP config (e.g., ~/.claude.json for global, or .mcp.json for per-project):

{
  "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.
setup_project	Set up KeepGoing in the current project. Adds session hooks and CLAUDE.md instructions for automatic checkpoints.

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

1. Add this MCP server to your AI coding assistant (Claude Code, Cursor, Windsurf, etc.)
2. Start coding. Use save_checkpoint from your AI assistant to capture what you did, what's next, and any blockers
3. Come back anytime. Your AI assistant calls get_momentum or get_reentry_briefing to pick up exactly where you left off
4. 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

Links

• Website
• VS Code Marketplace
• npm
• Issues & Feedback

License

MIT