memorysync-mcp-install
v1.0.2
Published
One command to add the MemorySync MCP servers to Claude Desktop, Claude Code, Cursor, Devin Desktop, VS Code, Codex and OpenCode.
Maintainers
Readme
memorysync-mcp-install
One command to connect the MemorySync MCP servers to your AI clients.
npx memorysync-mcp-installThat writes configuration for every MCP client it finds on the machine, then you restart the client. The first memory tool call opens a browser to sign in; there is no API key to copy.
What it configures
| Server | URL | Auth |
|---|---|---|
| memorysync | https://mcp.memorysync.io/mcp | OAuth 2.1 with PKCE, or a MemorySync API key |
| memorysync-docs | https://docs.memorysync.io/mcp | none |
Supported clients
| Client id | Config file |
|---|---|
| claude-code | ~/.claude.json |
| claude-desktop | OS application-support directory |
| cursor | ~/.cursor/mcp.json |
| devin-desktop | ~/.config/devin/mcp_config.json |
| windsurf | ~/.codeium/windsurf/mcp_config.json (legacy Cascade) |
| vscode | .vscode/mcp.json in the current workspace |
| opencode | ~/.config/opencode/opencode.json |
| codex | ~/.codex/config.toml |
Claude Desktop launches MCP servers as local processes, so it is configured
through the mcp-remote bridge. Every other client connects to the remote
Streamable HTTP endpoint directly.
Windsurf was renamed Devin Desktop, and the rename moved the config file. Both
paths are supported: devin-desktop is written on every machine, while the
legacy Cascade file is only updated if it already exists, so an install that has
not migrated still works and a current one gets no stray file.
Why there is no pip version
This package writes config files; it is not a library you import, so the language
it happens to be written in never reaches the user. Node is also already needed
for Claude Desktop, which launches MCP servers as local processes and therefore
goes through mcp-remote — npm-only. A pip build would not remove that, only
defer the surprise.
If you have no Node at all, you do not need this package. Both MemorySync MCP servers are hosted, so adding the URL by hand is the same outcome:
| Server | URL |
|---|---|
| memorysync | https://mcp.memorysync.io/mcp |
| memorysync-docs | https://docs.memorysync.io/mcp |
PyPI memorysync is the Python SDK for the REST API. It is unrelated to MCP and
does not install these servers.
Options
--list Show which clients were detected, change nothing
--client <ids> Comma-separated client ids (default: every detected client)
--server <names> memory, docs or both (default: both)
--all Write config even for clients that were not detected
--dry-run Print what would change, write nothing
--remove Remove the MemorySync entries again
--api-key <key> Configure headless auth via the MEMORYSYNC_API_KEY env varHow it treats your config files
- Only the MemorySync keys are added or removed. Everything else in the file is preserved, including comments in Codex's TOML.
- Any existing file is copied to
<file>.memorysync-backup-<timestamp>before a change is written. - A file that does not parse is reported and left untouched.
- Re-running is safe: an already-correct config reports "already up to date".
--api-keynever writes the key to disk. It configures the client to readMEMORYSYNC_API_KEYfrom the environment.
Manual setup
If you would rather edit the file yourself, --dry-run prints the exact result,
and https://memorysync.io/mcp-install.json carries the same details in
machine-readable form.
