Claude Command Runner MCP Server

MCP server for Warp Terminal. Drives Claude commands into your active Warp tab via warp:// deeplinks and OSC 777 events. Works from Claude Desktop or

Local serverstdioPython

What is the Claude Command Runner MCP Server?

MCP server for Warp Terminal. Drives Claude commands into your active Warp tab via warp:// deeplinks and OSC 777 events. Works from Claude Desktop or Warp's native

What you get

Claude Command Runner is a dual-consumer MCP server — the same binary serves Claude Desktop and Warp's native agent panel. It enables an LLM (whichever you've configured in either client) to:

Configuration and credentials

  • macOS 13.0 or later - Swift 6.0+ (Xcode 16+) - Claude Desktop - A supported terminal (Warp strongly recommended)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
execute_commandExecute with manual output retrieval
execute_with_auto_retrieveExecute with intelligent auto-retrieval
execute_pipelineChain commands with conditional logic
execute_with_streamingReal-time output streaming
save_templateSave reusable command pattern
run_templateExecute saved template with variables
list_templatesView all saved templates
delete_templateRemove a saved template by name
get_command_outputManually retrieve command output
preview_commandPreview without executing
suggest_commandSuggest commands (pass working_directory for git/Swift/Node-aware ideas)
list_recent_commandsView command history
self_checkSystem health diagnostics
copy_to_clipboardWrite text to macOS clipboard
read_from_clipboardRead current clipboard content
set_notification_preferenceToggle macOS notifications
get_environment_contextProbe git, venv, Node, Docker state
execute_and_parseExecute and parse output to structured JSON
capture_environmentSnapshot your real shell environment (sources your login profile)
diff_environmentCompare two environment snapshots
save_workspace_profileSave project context as named profile
load_workspace_profileRestore a saved project context
list_workspace_profilesView all saved profiles
delete_workspace_profileRemove a workspace profile
open_terminal_tabOpen a new named terminal tab (Warp: via warp://action/new_tab deeplink in v6.0)
send_to_sessionSend command to a specific tab (AppleScript keystroke; tab-targeting limited on Warp)
list_sessionsView active terminal sessions
close_sessionClose a named session
cleanup_sessionsBulk-remove stale sessions; optionally close their tabs
check_interactiveClassify a command for TTY/stdin requirements before running it
add_file_watchWatch directory and trigger command on changes
remove_file_watchStop watching a directory
list_file_watchesView active watchers
ssh_executeRun command on remote host via SSH
save_ssh_profileSave SSH connection profile
list_ssh_profilesView saved SSH profiles
delete_ssh_profileRemove an SSH profile
focus_warp_sessionDispatch warp://session/ to focus a Warp pane (UUID must be one Warp recognises — typically from the optional shell shim's events)
emit_warp_eventBuild a printf invocation that emits an OSC 777 warp://cli-agent JSON event into Warp's UI. Schema: session_start / prompt_submit / tool_complete / stop / permi
shell_shim_statusReport optional shell-shim socket state and recent events

How to install the Claude Command Runner MCP Server

{
  "mcpServers": {
    "warp-command-runner": {
      "command": "/Applications/Warp Command Runner.app/Contents/MacOS/warp-command-runner",
      "args": []
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • macOS 13.0 or later - Swift 6.0+ (Xcode 16+) - Claude Desktop - A supported terminal (Warp strongly recommended)

Example prompts to try

  • “Use Claude Command Runner to Prerequisites.”

Frequently asked questions

MCP server for Warp Terminal. Drives Claude commands into your active Warp tab via warp:// deeplinks and OSC 777 events. Works from Claude Desktop or Warp's native Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.