mcpField
C
carry

carry

Local
carry-si.vercel.appOther0Updated today

About carry

carry is a command-line tool and MCP connector for moving sessions or projects across Claude Code, Codex, and other chat tools. It shares full session histories through the user's own Google Drive and can bundle project chats, memory notes, and handoff details.

Key features

  1. 01Move Claude Code and Codex sessions
  2. 02Share sessions through Google Drive
  3. 03Pair with friends to exchange sessions
  4. 04Share project chats and memory notes
  5. 05Return sessions or send them back automatically

Use cases

  1. 01Continue a coding session on another device
  2. 02Hand off a session and receive it back
  3. 03Share project chats and handoff details with a team
  4. 04Share a summary and prompt through chat apps

MCP support

carry can run as an MCP connector, letting clients request session sharing, check an inbox, or return a session using natural language.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"vamzzisme-carry": {
"command": "npx",
"args": [
"-y",
"@heyvamz/carry"
]
}
}
}
Run commandnpx -y @heyvamz/carry

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@heyvamz/carry0.4.4

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

carry

AirDrop for AI chats and projects. Serverless: it travels through your own Google Drive, nothing is hosted by us. Out of tokens? Keep coding.

carry moves a Claude Code or Codex session, with its full history, to another account, another tool or a friend's laptop. Or hand over a whole project, memory and all, so the next agent knows what was tried and why.

Shared chats go into your own Google Drive. There is no carry server and no account with us.

Website · GitHub · built by @heyvxmz · A VXMZ product

Why not just paste a summary?

A summary keeps what the AI chose to remember. carry keeps every message, command, error and dead end, and the next agent resumes it as its own session, so it doesn't retry the fix that already failed.

Install

Needs Node 22.15 or newer. Works on macOS, Windows and Linux.

npm install -g @heyvamz/carry
carry install-skill                 # adds /carry to Claude Code and Codex
carry setup --web --as yourname     # sign in to Google Drive in your browser

On Linux you may need sudo npm install -g @heyvamz/carry.

Already use Google Drive for desktop, Dropbox or iCloud? Run carry setup (or carry setup ~/Dropbox/carry) instead and share that one folder with your group.

Use it

Inside Claude Code or Codex, type /carry and it walks you through everything. Or from a terminal.

With friends: pair once, then just pick from your inbox
# You
carry friend add [email protected]        # prints a pairing code: send it to Riya (any chat app)
# Riya
carry friend add <your code>           # prints her code back
# You
carry friend add <Riya's code>         # done, both ways

Then:

# You
carry list                                       # your chats, by name
carry share fix-the-login-bug --to riya          # into Riya's inbox
# Riya
carry inbox                                      # 1. fix-the-login-bug   chat from you   NEW
carry open 1 --to codex                          # continues on Riya's account (or --to claude_code)
carry return fix-the-login-bug                   # when she's done: back to you, with her work
# You
carry inbox                                      # 1. fix-the-login-bug   UPDATED by Riya (+18 messages)
carry open 1 --to claude_code                    # continue from the latest

If you also kept working on your copy meanwhile, carry opens Riya's version next to yours and overwrites nothing. Add --auto-return when sharing to have her carry send it back on its own (run carry install-hook for Claude Code). Everything Riya's carry reads is encrypted with a key that only lives in your pairing codes.

Without pairing
carry share fix-the-login-bug --with [email protected]   # Google emails Riya a link
carry open <drive link> --to codex                    # on Riya's laptop
Share a whole project
carry projects                      # your repos, with chats and Claude memory notes
carry projects my-app               # the chats in one, plus "related" chats started elsewhere that worked on it
carry share --project my-app --add <related chat> --to riya

It bundles the newest chats (and any you add), Claude Code's memory notes, CLAUDE.md / AGENTS.md and a handoff. The code itself goes through git. Riya clones the repo, then carry open <number> --to claude_code --dir ./my-app, and later carry return --project my-app brings back her chats and any memory notes Claude picked up.

Claude Code gets your memory notes and a handoff note where it reads them at the start of a session; Codex gets a .carry/ folder and a pointer in AGENTS.md. Nothing of theirs is overwritten.

Chat apps

claude.ai, ChatGPT and the Claude app keep chats on their servers, so carry shares a written summary there: carry open <link> --to chat copies a prompt and shows the handoff.md to attach.

No terminal? Ask your AI

carry also runs as an MCP connector. Add it once, then just say "share this chat with Riya", "what's in my carry inbox?" or "send it back to Riya".

Claude Desktop, one click: download carry.mcpb and double-click it.

Claude Code plugin (connector + /carry skill together):

claude plugin marketplace add vamzzisme/carry
claude plugin install carry@carry

Claude Desktop by hand (Settings, Developer, Edit Config) and Cursor (~/.cursor/mcp.json):

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

Codex (~/.codex/config.toml):

[mcp_servers.carry]
command = "npx"
args = ["-y", "@heyvamz/carry@latest", "mcp"]

On Windows, use "command": "cmd" and put "/c", "npx" at the start of the args. Restart the app after saving.

Commands

CommandWhat it does
carry listYour Claude Code and Codex chats, by name
carry name <chat> <new name>Rename a chat
carry friend add <email or code> · carry friendsPair once with a friend; see who's paired
carry share <chat> --to <friend> [--auto-return]Into their inbox
carry inbox · carry open <number>What friends sent you, including your own chats coming back UPDATED
carry return <chat> · carry return --project <name>Send borrowed work back to its owner
carry share <chat> [--with emails] [--link]Share without pairing. --link lets anyone with the link open it
carry projects [name]Your projects, or the chats in one (including related chats started elsewhere)
carry share --project [name] [--add chats] [--skip chats] [--related] [--to friend]Share a whole repo
carry open <link, file or name> --to claude_code|codex|chatContinue it here
carry packsWhat you've shared
carry completion zsh|bash|powershellTab completion script. carry setup turns it on for you; open a new terminal after
carry syncRe-upload shared chats that changed
carry note "<name>" --handoff summary.mdShare just a summary (from a chat app)
carry doctorVersions, txcript, and how sharing is set up
carry updateGet the newest version. carry tells you when one is out

Privacy

  • carry runs on your computer. Chats go from your computer to your Google Drive and nowhere else.
  • It asks Google for the narrowest Drive permission: it can only see files it created.
  • API keys, tokens, private keys and KEY=value lines are replaced with [REDACTED] before anything leaves your laptop. This is pattern based, so don't share chats full of secrets you care about.
  • Nothing is shared unless you pick it.
  • We collect nothing. carry has no server and no telemetry; the only network calls are to Google Drive (your account), npm (update check) and GitHub (downloading txcript once).
  • Shared files stay in your Drive until you delete them there. Local settings live in ~/.carry/ until you delete that folder.
  • Who sees a shared chat is up to you: paired friends, the emails you name, or anyone with the link if you choose --link.
  • Contact: [email protected]

Full policy: carry-si.vercel.app/privacy

Notes

  • Google may show "Google hasn't verified this app" while carry is in Google's testing stage. Click Advanced, then continue.
  • Stop the daily update check with CARRY_NO_UPDATE_CHECK=1.
  • Something not working? See Troubleshooting.

Built on txcript by SkillSync, which converts chats between tools. Apache-2.0 license.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.