# Context Sync

> Universal AI Memory - Sync context across Claude, VsCode, Cursor, Continue, Windsurf, Zed & more

- **Type:** MCP server
- **Install:** `agentstack add mcp-intina47-context-sync`
- **Verified:** Pending review
- **Seller:** [Intina47](https://agentstack.voostack.com/s/intina47)
- **Installs:** 0
- **Latest version:** 1.0.1
- **License:** MIT
- **Upstream author:** [Intina47](https://github.com/Intina47)
- **Source:** https://github.com/Intina47/context-sync

## Install

```sh
agentstack add mcp-intina47-context-sync
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

## 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:

```bash
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](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](docs/TROUBLESHOOTING.md) and [docs/CONFIG.md](docs/CONFIG.md).

## Optional Notion Setup

Run the setup wizard if you want Notion integration:

```bash
context-sync-setup
```

or:

```bash
npx context-sync-setup
```

Notion support is intentionally read-only at the tool surface:
- `notion({ action: "search", query: "..." })`
- `notion({ action: "read", pageId: "..." })`

## First-Time Workflow

Start every new session by setting the project first:

```text
1. set_project({ path: "/absolute/path/to/project" })
2. recall()
3. structure({ depth: 2 })
4. read_file({ path: "src/index.ts" })
5. remember({ type: "decision", content: "Use SQLite for local storage" })
```

Recommended pattern:
- `set_project` once per project/session start
- `recall` to recover context
- `structure` and `search` to explore
- `read_file` for focused inspection
- `remember` when something should survive the current session

## Git Integration

When you run `set_project` inside a git repository, Context Sync can install hooks for automatic context capture.

Installed hooks:
- `post-commit`
- `pre-push`
- `post-merge`
- `post-checkout`

Hooks are marked with `Context Sync Auto-Hook`, and existing hooks are backed up first.

The `git` tool supports:
- `status`
- `context`
- `hotspots`
- `coupling`
- `blame`
- `analysis`

## Data And Config

Default locations:
- Database: `~/.context-sync/data.db`
- Config: `~/.context-sync/config.json`
- Install status: `~/.context-sync/install-status.json`

Custom database options:
- CLI: `context-sync --db-path /absolute/path/to/db`
- Env var: `CONTEXT_SYNC_DB_PATH`

See [docs/DATA.md](docs/DATA.md) for storage details.

## Supported Platforms

- Claude Desktop
- Cursor
- VS Code + GitHub Copilot
- Continue.dev
- Zed
- Windsurf
- Codeium
- TabNine
- Codex CLI
- Claude Code
- Antigravity

## Docs

- [docs/TOOLS.md](docs/TOOLS.md)
- [docs/CONFIG.md](docs/CONFIG.md)
- [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)
- [docs/DATA.md](docs/DATA.md)
- [docs/RELEASE_NOTES.md](docs/RELEASE_NOTES.md)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Intina47](https://github.com/Intina47)
- **Source:** [Intina47/context-sync](https://github.com/Intina47/context-sync)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Versions

- **1.0.1** — security scan: pending review — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-intina47-context-sync
- Seller: https://agentstack.voostack.com/s/intina47
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.