# Warp Command Runner MCP server

> Lets local chat AI hosts run terminal commands on macOS, capture output, and manage files, SSH, and templates over MCP.

- Repository: https://github.com/M-Pineapple/warp-command-runner
- Page: https://hostedmcp.org/servers/m-pineapple/warp-command-runner
- Transport: —
- Stars: 18
- License: MIT

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `WCR_CODESIGN_IDENTITY` | no | no |  |
| `WCR_HOME` | no | no |  |

## Tools (40)

- `execute_command`
- `execute_with_auto_retrieve`
- `execute_pipeline`
- `execute_with_streaming`
- `save_template`
- `run_template`
- `list_templates`
- `delete_template`
- `get_command_output`
- `preview_command`
- `suggest_command`
- `list_recent_commands`
- `self_check`
- `copy_to_clipboard`
- `read_from_clipboard`
- `set_notification_preference`
- `get_environment_context`
- `execute_and_parse`
- `capture_environment`
- `diff_environment`
- `save_workspace_profile`
- `load_workspace_profile`
- `list_workspace_profiles`
- `delete_workspace_profile`
- `open_terminal_tab`
- `send_to_session`
- `list_sessions`
- `close_session`
- `cleanup_sessions`
- `check_interactive`
- `add_file_watch`
- `remove_file_watch`
- `list_file_watches`
- `ssh_execute`
- `save_ssh_profile`
- `list_ssh_profiles`
- `delete_ssh_profile`
- `focus_warp_session`
- `emit_warp_event`
- `shell_shim_status`

## FAQ

### What does Warp Command Runner let an AI client do?

It lets an MCP host execute terminal commands, chain pipelines, stream output, save templates, use the clipboard, and run SSH commands on macOS.

### Does it require macOS and Swift?

Yes. It requires macOS 13 or later and Swift 6.0+ (Xcode 16+), and you build it from source with ./build.sh.

### Do all tools need code signing?

No. An unsigned build is enough for 34 of the 40 tools; the five Warp-routing keystroke tools need a signed app in /Applications.

### Where does it store config and command history?

Config, history, templates, and SSH profiles go in ~/.warp-command-runner, or another folder if you set WCR_HOME to an absolute path.
