WezTerm MCP
Enables programmatic control of the WezTerm terminal emulator through the Model Context Protocol. It allows users to manage panes, tabs, and windows while reading terminal content or sending commands directly to the terminal environment.
What is WezTerm MCP?
WezTerm MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables programmatic control of the wezterm terminal emulator through the model context protocol. it allows users to manage panes, tabs, and windows while reading terminal content or sending commands ...
Enables programmatic control of the WezTerm terminal emulator through the Model Context Protocol. It allows users to manage panes, tabs, and windows while reading terminal content or sending commands directly to the terminal environment.
This server falls under the Developer Tools and File Systems categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables programmatic control of the WezTerm terminal emulato
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx weztermConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use WezTerm MCP
WezTerm MCP Server exposes programmatic control of the WezTerm terminal emulator through the Model Context Protocol, allowing AI assistants like Claude to manage panes, tabs, and windows, read terminal output, and send commands without the user switching context. It covers the full WezTerm workspace model — splitting panes, activating directional panes, zooming, renaming workspaces, spawning new processes, and more. Terminal power users and developers who run WezTerm as their daily driver will find it valuable for delegating terminal orchestration tasks to Claude.
Prerequisites
- WezTerm terminal emulator installed and running (wezterm.app or the Linux equivalent)
- Python 3.8 or later with uvx (uv) installed for running the server
- An MCP-compatible client such as Claude Desktop
Install uvx (uv package manager)
The WezTerm MCP server is run via uvx, which is part of the uv Python package manager. Install uv if you don't have it.
curl -LsSf https://astral.sh/uv/install.sh | shAdd the server using the Claude MCP CLI
The easiest way to register the server is with the 'claude mcp add' command, which writes the config entry automatically.
claude mcp add wezterm -- uvx mcp-server-weztermOr configure manually in claude_desktop_config.json
Alternatively, add the entry directly to your Claude Desktop configuration file.
{
"mcpServers": {
"wezterm": {
"command": "uvx",
"args": ["mcp-server-wezterm"]
}
}
}Restart Claude Desktop
Fully quit and reopen Claude Desktop so it starts the WezTerm MCP server and registers all tools.
Use the terminal management tools
The server exposes tools including: list_panes, get_text, split_pane, activate_pane, activate_pane_direction, kill_pane, zoom_pane, move_pane_to_new_tab, activate_tab, set_tab_title, set_window_title, list_clients, spawn, send_text, and rename_workspace.
WezTerm MCP Examples
Client configuration
Claude Desktop configuration for the WezTerm MCP server via uvx.
{
"mcpServers": {
"wezterm": {
"command": "uvx",
"args": ["mcp-server-wezterm"]
}
}
}Prompts to try
Example prompts for controlling WezTerm through Claude.
- "List all open WezTerm panes and their current content."
- "Split the current pane vertically and run 'npm test' in the new pane."
- "Read the output from pane 3 and summarise any errors."
- "Rename the current WezTerm workspace to 'project-x'."
- "Send the command 'git status' to the pane running my dev server."
- "Zoom the current pane to full screen."Troubleshooting WezTerm MCP
uvx command not found when Claude Desktop tries to start the server
Install uv with 'curl -LsSf https://astral.sh/uv/install.sh | sh' and ensure the install directory (~/.cargo/bin or ~/.local/bin) is in your PATH. Restart your terminal session after installing.
Server starts but tools return 'WezTerm not running' errors
The MCP server communicates with a running WezTerm instance via its CLI. Ensure WezTerm is open and running before invoking tools. On macOS, confirm the wezterm CLI is in your PATH by running 'which wezterm'.
send_text sends to the wrong pane
Use list_panes first to get the correct pane IDs, then specify the target pane ID explicitly in the send_text call rather than relying on the currently active pane.
Frequently Asked Questions about WezTerm MCP
What is WezTerm MCP?
WezTerm MCP is a Model Context Protocol (MCP) server that enables programmatic control of the wezterm terminal emulator through the model context protocol. it allows users to manage panes, tabs, and windows while reading terminal content or sending commands directly to the terminal environment. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install WezTerm MCP?
Follow the installation instructions on the WezTerm MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with WezTerm MCP?
WezTerm MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is WezTerm MCP free to use?
Yes, WezTerm MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
WezTerm MCP Alternatives — Similar Developer Tools Servers
Looking for alternatives to WezTerm MCP? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up WezTerm MCP in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use WezTerm MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.