# SaveContext-MCP

> Persistent memory for AI coding agents via MCP tools. USE WHEN user says "save context", "remember this", "checkpoint", "resume session", "prepare for compaction", "wrap up", OR when starting work on a project that may span sessions.

- Author: SHAN Ξ  M⚡️
- Repository: greenfieldlabs-inc/savecontext
- Version: 20260205134914
- Stars: 14
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/greenfieldlabs-inc/savecontext
- Web: https://mule.run/skillshub/@@greenfieldlabs-inc/savecontext~SaveContext-MCP:20260205134914

---

---
name: SaveContext-MCP
description: Persistent memory for AI coding agents via MCP tools. USE WHEN user says "save context", "remember this", "checkpoint", "resume session", "prepare for compaction", "wrap up", OR when starting work on a project that may span sessions.
---

# SaveContext (MCP)

Save decisions, track progress, and maintain continuity across coding sessions.

## Critical Rules

**NEVER use `context_session_start` when the user says "resume".** The word "resume" (or "continue session", "pick up where I left off") ALWAYS means:
1. `context_list_sessions` to find the session
2. `context_session_resume` to resume it

`context_session_start` creates NEW sessions. It has limited auto-resume that only works for active sessions on the exact same project path. Using it to "resume" almost always creates duplicates.

## Quick Actions

For most requests, use these patterns directly:

| User Says | Do This |
|-----------|---------|
| "save this decision" | `context_save key="..." value="..." category="decision"` |
| "remember this" | `context_save key="..." value="..." category="note"` |
| "checkpoint" | `context_checkpoint name="..."` |
| "wrap up" | See [WrapUp workflow](#wrap-up) |
| "resume [topic]" | **MUST** search sessions, then `context_session_resume` |
| "start session" / "begin work" | `context_session_start` (new sessions only) |

## Workflow Routing

| Workflow | Trigger | File |
|----------|---------|------|
| **QuickSave** | "save", "remember", "note this" | `Workflows/QuickSave.md` |
| **SessionStart** | Starting work, "begin session" | `Workflows/SessionStart.md` |
| **WrapUp** | "wrap up", "end of day", "checkpoint everything" | `Workflows/WrapUp.md` |
| **Resume** | "resume", "continue", "pick up where I left off" | `Workflows/Resume.md` |
| **Compaction** | "prepare for compaction", context getting long | `Workflows/Compaction.md` |
| **IssueTracking** | "create issue", "track this bug" | `Workflows/IssueTracking.md` |
| **Planning** | "plan this feature", "implement [complex]", multi-task work | `Workflows/Planning.md` |
| **Advanced** | Multi-day projects, multi-agent, branch switching, subagents | `Workflows/AdvancedWorkflows.md` |

## Examples

**Example 1: Quick save during work**
```
User: "remember that we chose JWT over sessions for auth"
→ context_save key="auth-decision" value="Chose JWT over sessions for stateless scaling" category="decision" priority="high"
→ Saved. No session management needed.
```

**Example 2: Starting a work session**
```
User: "let's work on the payment feature"
→ context_session_start name="payment-feature" description="Implementing Stripe integration"
→ Session started (or resumed if exists)
```

**Example 3: Wrapping up**
```
User: "wrap up for today"
→ Invokes WrapUp workflow
→ Saves progress, creates checkpoint, pauses session
```

## Do NOT Automatically

- Start sessions for quick saves (just save the item)
- Run multiple tools when one suffices
- Load full reference docs unless user asks how something works

## Reference

Full tool documentation: `Workflows/Reference.md`