# carry

> carry is an open-source MCP server for developer tools. Hand a Claude Code or Codex session to a friend or another account via Google Drive. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://carry-si.vercel.app
- **Repository:** https://github.com/vamzzisme/carry
- **MCP Registry name:** io.github.vamzzisme/carry
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-14

## About

Running out of tokens mid-session is the problem carry targets. It moves the full history of a Claude Code or Codex chat, every message, command and failed attempt, so the next agent resumes it as a real session instead of working from a summary. It can also bundle a whole project: recent chats, Claude memory notes, CLAUDE.md and AGENTS.md, plus a handoff note, while the code itself travels through git.

There is no carry server and no account with its makers. Packs go into your own Google Drive using the narrowest permission, which lets carry see only files it created. API keys, tokens and private keys are replaced with [REDACTED] before upload, and each pack is encrypted with a key that lives in your pairing codes.

Pair with a friend once, then use carry list, share, inbox and open. A recipient can continue in Claude Code or Codex on their own account and send the work back with carry return. Plain chats in claude.ai or ChatGPT live on those services' servers, so there carry hands over a written summary.

## Features

- **Full session transfer:** Moves every message, command and dead end rather than a summary.
- **Whole-project handoff:** Bundles recent chats, memory notes, CLAUDE.md, AGENTS.md and a handoff note.
- **Your own Drive:** Packs travel through your Google Drive, or a shared folder such as Dropbox or iCloud.
- **Secret redaction:** Keys, tokens and KEY=value lines are replaced with [REDACTED] before upload.
- **Return to sender:** carry return sends the recipient's work back, shown as UPDATED in your inbox.
- **Cross-tool resume:** Open a Claude Code chat in Codex, or the other way round.

## Good for

- Continue a session on another account after hitting a usage limit
- Pass a debugging chat to a teammate with every failed attempt included
- Move a project's chats and memory notes to a new laptop
- Switch a session between Claude Code and Codex
- Hand over a written summary of a ChatGPT or claude.ai chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add carry -- npx -y @heyvamz/carry
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "carry": {
      "command": "npx",
      "args": [
        "-y",
        "@heyvamz/carry"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "carry": {
      "command": "npx",
      "args": [
        "-y",
        "@heyvamz/carry"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "carry": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@heyvamz/carry"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "carry": {
      "command": "npx",
      "args": [
        "-y",
        "@heyvamz/carry"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "carry": {
      "command": "npx",
      "args": [
        "-y",
        "@heyvamz/carry"
      ]
    }
  }
}
```

## FAQ

### Does carry run a server?

No. It runs on your laptop and uses your own Google Drive; there is no carry server and no account with the makers.

### What does it need to install?

Node 22.15 or newer, on macOS, Windows or Linux, then npm install -g @heyvamz/carry.

### Can my friend send the work back?

Yes. carry return sends it back and it appears in your inbox as UPDATED; if you also kept working, their version opens next to yours and nothing is overwritten.

### Are secrets uploaded?

API keys, tokens, private keys and KEY=value lines are redacted before anything leaves your laptop.

### Is carry free?

Yes. carry is open source, so you can use and self-host it for free.

### How do I add carry to Claude Code?

Run this command in your terminal: claude mcp add carry -- npx -y @heyvamz/carry

### What are the best alternatives to carry?

The closest alternatives to carry are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/carry
