context-sync

MCP.Pizza Chef: Intina47

Decisions, constraints, and unfinished work get saved on your own computer, so a brand new conversation picks up where the last one stopped instead of starting cold. It can also walk a project's folders, search inside the files, and report what recent commits changed, which gives an assistant real footing before it suggests anything. Installing it configures Claude Desktop, Cursor, VS Code, Continue, Zed, Windsurf, Codex, and Claude Code for you. An optional read-only Notion lookup is available.

Coding
Notes

Use This MCP server To

Pick a project back up where I left off last week Save a decision so I stop revisiting it Ask what constraints we agreed on for this project See what changed in the last few commits Search a codebase without pasting files into chat Look up a Notion page without leaving the conversation

README

Context Sync

Local-first project memory for AI coding tools over MCP.

Context Sync gives an agent a persistent memory layer for a codebase:

  • project identity and tech stack
  • active work, decisions, constraints, and caveats
  • structured file exploration
  • git-aware context
  • optional read-only Notion lookup

Context Sync

What It Does

Context Sync is built for session continuity. Instead of relying on a model to remember earlier conversations, it stores the project context that matters and makes it retrievable through a small MCP tool surface.

The current core tools are:

  • set_project
  • remember
  • recall
  • read_file
  • search
  • structure
  • git
  • notion

Install

Install globally:

npm install -g @context-sync/server

Auto-configuration runs during global install. After install, restart your AI tool.

If you install locally instead of globally, auto-config does not run. Use the manual config guide in docs/CONFIG.md.

Verify

Check that context-sync appears in your MCP tool list:

  • Claude Desktop: open the tools list
  • Cursor: open the tools list
  • VS Code / Copilot Chat Agent mode: check tools
  • Continue.dev: open the Continue panel
  • Codex CLI: codex mcp list
  • Claude Code: claude mcp list

If auto-config fails, use docs/TROUBLESHOOTING.md and docs/CONFIG.md.

Optional Notion Setup

Run the setup wizard if you want Notion integration:

context-sync-setup

or:

npx context-sync-setup

Notion support is intentionally read-only at the tool surface:

  • notion({ action: "search", query: "..." })
  • notion({ action: "read", pageId: "..." })

context-sync FAQ

Do I need to sign up for anything?
No. Everything is stored locally, and only the optional Notion lookup asks for credentials.
Where is my information kept?
In a database file in your home folder, on your own computer.
Which apps does it work in?
Claude Desktop, Cursor, VS Code with Copilot, Continue, Zed, Windsurf, Codeium, Codex, and Claude Code.
How hard is setup?
One install command configures the supported tools automatically; you just restart the app afterwards.
Can I use this to carry decisions between sessions?
Yes. You tell it to remember something, and a later conversation can recall it.
Can it change my Notion pages?
No. The Notion connection is read-only, limited to searching and reading.