@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.

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. | | get_reentry_briefing | Get a synthesized re-entry briefing with focus, recent activity, and suggested next steps. | | get_session_history | Get recent session checkpoints in chronological order. Supports branch filtering and configurable limit. | | 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. Install the KeepGoing VS Code extension to capture session data automatically
2. Add this MCP server to your AI coding assistant (Claude Code, Cursor, Windsurf, etc.)
3. Start coding. Checkpoints are saved on git commits, branch switches, and periods of inactivity
4. Come back anytime. Your AI assistant calls get_momentum or get_reentry_briefing to pick up exactly where you left off

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

Requirements

• KeepGoing VS Code extension installed and active
• Node.js 18+

Links

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

License

MIT