Usage Examples

You do not need to memorize tool names. Just describe what you want in plain English and Claude Code will call the right MCP tool.

Push a session to the cloud

You: Save this conversation so I can continue on my laptop. Call it “billing API” and tag it “backend”.

Claude Code calls teleport_push with label: "billing API" and tags: ["backend"].

Claude: Session teleported to CodeTeleport
  id      : c3a05473
  size    : 284 KB
  machine : Alices-Desktop.local
  messages: 47
You can pull this on your laptop and resume with claude --resume c3a05473.

List cloud sessions

You: What sessions do I have?

Claude Code calls teleport_list.

Claude: You have 3 sessions stored in CodeTeleport:

# ID Machine Project Date Size
1 c3a05473 Alices-Desktop ~/projects/billing-api Mar 28, 2026 284 KB
2 7f2b1e90 Alices-Laptop ~/work/frontend Mar 27, 2026 512 KB
3 a91d44c2 Alices-Desktop ~/projects/auth-service Mar 25, 2026 198 KB

Want me to pull one of these?

#	ID	Machine	Project	Date	Size
1	c3a05473	Alices-Desktop	~/projects/billing-api	Mar 28, 2026	284 KB
2	7f2b1e90	Alices-Laptop	~/work/frontend	Mar 27, 2026	512 KB
3	a91d44c2	Alices-Desktop	~/projects/auth-service	Mar 25, 2026	198 KB

Pull a session

You: Pull my latest session.

Claude Code calls teleport_pull with the most recent session ID.

Claude: Session installed.
  id: c3a05473
  Resume with: claude --resume c3a05473
All paths have been rewritten from /Users/alice to /Users/bob automatically.

Pull to a specific directory

You: Pull session 7f2b1e90 to /home/bob/repos/frontend.

Claude Code calls teleport_pull with sessionId: "7f2b1e90..." and targetDir: "/home/bob/repos/frontend".

Claude: Session installed and anchored at /home/bob/repos/frontend. Resume with claude --resume 7f2b1e90.

See path rewriting for details on how directory anchoring works.

Browse local sessions

You: Show me my local sessions.

Claude Code calls teleport_local_list.

Claude: You have 5 local Claude Code sessions:

ID Project Messages Last active Size
c3a05473… billing-api 47 Mar 28, 14:32 284 KB
e8f21a03… billing-api 12 Mar 28, 09:15 91 KB
7f2b1e90… frontend 83 Mar 27, 17:44 512 KB
d4419bc1… docs-site 29 Mar 26, 11:02 156 KB
a91d44c2… auth-service 61 Mar 25, 16:30 198 KB

These are on your local machine. Want me to push any of them to the cloud?

ID	Project	Messages	Last active	Size
c3a05473…	billing-api	47	Mar 28, 14:32	284 KB
e8f21a03…	billing-api	12	Mar 28, 09:15	91 KB
7f2b1e90…	frontend	83	Mar 27, 17:44	512 KB
d4419bc1…	docs-site	29	Mar 26, 11:02	156 KB
a91d44c2…	auth-service	61	Mar 25, 16:30	198 KB

Check account status

You: How’s my CodeTeleport account looking?

Claude Code calls teleport_status.

Claude: Here is your CodeTeleport status:

CodeTeleport Status
  user     : alice@example.com
  device   : Bobs-Laptop.local
  api      : https://api.codeteleport.com
  plan     : free
  sessions : 3 / 25
  devices  : 2 / 3
  last push: 3/28/2026, 2:32:14 PM (Alices-Desktop.local)

You are on the free plan with 22 sessions remaining.

Delete a session

You: Delete that old auth-service session.

Claude Code calls teleport_delete with the session ID.

Claude: Session a91d44c2-… deleted from CodeTeleport. This cannot be undone.

Tool reference

For the full list of inputs and parameters, see the MCP Tools reference.