MCP Tools
The CodeTeleport MCP server registers six tools. Claude Code (or any MCP-compatible agent) can call them in response to natural language prompts.
Tool Reference
Section titled “Tool Reference”teleport_push
Section titled “teleport_push”Push the current Claude Code session to CodeTeleport cloud storage. Bundles the full conversation (JSONL, subagents, file history, paste cache, shell snapshots) and uploads it so you can resume on another machine. If the session was previously pushed, it is overwritten with the latest version.
| Input | Type | Required | Description |
|---|---|---|---|
label | string | no | Human-readable name for the session |
tags | string[] | no | Tags for filtering (e.g. ["work", "frontend"]) |
Example prompt:
Save this conversation so I can continue on my laptop.Label it "auth refactor" and tag it "work".teleport_pull
Section titled “teleport_pull”Pull a session from CodeTeleport cloud to this machine. Downloads the bundle, rewrites all internal paths for this machine’s username and directory structure, and installs it so you can resume with claude --resume.
| Input | Type | Required | Description |
|---|---|---|---|
sessionId | string | no | Pull a specific session by ID. If omitted, lists available sessions. |
targetDir | string | no | Anchor the session at this directory path (see path rewriting) |
machine | string | no | Filter listed sessions by source machine name |
limit | number | no | Max sessions to list (default: 10) |
Example prompt:
Pull my latest session from my work machine.Pull session c3a05473 to /home/bob/projects/myapp.teleport_list
Section titled “teleport_list”List all sessions stored in CodeTeleport cloud. Shows session ID, source machine, project path, date, size, message count, and tags.
| Input | Type | Required | Description |
|---|---|---|---|
machine | string | no | Filter by machine name |
tag | string | no | Filter by tag |
limit | number | no | Max results (default: 20) |
Example prompt:
What sessions do I have stored in CodeTeleport?Show me sessions tagged "work" from my desktop.teleport_local_list
Section titled “teleport_local_list”List all Claude Code sessions on the local machine. Scans ~/.claude/projects/ for session files and shows session ID, project name, message count, timestamps, and file size. No cloud access needed — reads directly from the local filesystem.
| Input | Type | Required | Description |
|---|---|---|---|
| (none) | This tool takes no inputs. |
Example prompt:
Show me my local Claude Code sessions.teleport_status
Section titled “teleport_status”Show CodeTeleport account status. Displays your email, device name, API URL, plan, session and device usage, and last push time.
| Input | Type | Required | Description |
|---|---|---|---|
| (none) | This tool takes no inputs. |
Example prompt:
What's my CodeTeleport status?teleport_delete
Section titled “teleport_delete”Permanently delete a session from CodeTeleport cloud storage. This cannot be undone.
| Input | Type | Required | Description |
|---|---|---|---|
sessionId | string | yes | Full session ID to delete |
Example prompt:
Delete session c3a05473-9f12-4a2b-ae27-9478ab66d216.Error Handling
Section titled “Error Handling”All tools are wrapped in a safe handler. If a tool call fails — authentication error, network timeout, invalid session ID — the response includes isError: true alongside an error message. Your agent will typically surface this as a natural-language explanation.
Common errors:
| Error | Cause |
|---|---|
not authenticated | No API token configured. Run codeteleport auth login. |
session not found | The session ID does not exist or was already deleted. |
plan limit exceeded | You have hit your session or device limit. See Plans & Limits. |
Next step
Section titled “Next step”See usage examples for full conversation walkthroughs showing these tools in action.