About
Wezterm — Model Context Protocol server
README
MCP server that exposes WezTerm terminal control via the Model Context Protocol.
Usage
Claude Desktop / Claude Code
With uvx (recommended):
{
"mcpServers": {
"wezterm": {
"command": "uvx",
"args": ["mcp-server-wezterm-rs"]
}
}
}
claude mcp add wezterm -- uvx mcp-server-wezterm
With rvx:
{
"mcpServers": {
"wezterm": {
"command": "rvx",
"args": ["mcp-server-wezterm"]
}
}
}
Other installation methods
With Nix:
nix run github:vaporif/mcp-server-wezterm
With cargo:
cargo install mcp-server-wezterm
Tools
Pane Management
| Tool | Description |
|---|---|
list_panes |
List all windows, tabs and panes |
get_text |
Read terminal screen/scrollback content |
get_pane_direction |
Get adjacent pane ID in a direction |
split_pane |
Split a pane (left/right/top/bottom) |
activate_pane |
Focus a pane by ID |
activate_pane_direction |
Focus adjacent pane by direction |
kill_pane |
Kill a pane |
adjust_pane_size |
Resize a pane directionally |
zoom_pane |
Zoom/unzoom/toggle a pane |
move_pane_to_new_tab |
Move a pane into a new tab |
Tab & Window
| Tool | Description |
|---|---|
activate_tab |
Activate a tab by ID, index, or relative offset |
set_tab_title |
Change tab title |
set_window_title |
Change window title |
Other
| Tool | Description |
|---|---|
list_clients |
List connected clients |
spawn |
Spawn a command in a new window or tab |
send_text |
Send text to a pane (bracketed paste) |
rename_workspace |
Rename a workspace |
Development
Requires just, taplo, and typos.
just check # clippy + test + fmt + taplo + typos
just build # cargo build
just test # cargo test
just fmt # format code and TOML
just lint # cargo clippy
just deny # cargo deny check
License
MIT
Installing Wezterm
This server has no published package — it is built from source. Open the repository and follow its README.
▸ github.com/vaporif/mcp-server-weztermFAQ
Is Wezterm MCP free?
Yes, Wezterm MCP is free — one-click install via Unyly at no cost.
Does Wezterm need an API key?
No, Wezterm runs without API keys or environment variables.
Is Wezterm hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install Wezterm in Claude Desktop, Claude Code or Cursor?
Open Wezterm on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectCompare Wezterm with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs