Wtp MCP Server

A Model Context Protocol (MCP) server for [wtp](https://github.com/satococoa/wtp) (Worktree Plus), written in Rust. It lets AI assistants manage Git

Local serverstdio

What is the Wtp MCP MCP server?

A Model Context Protocol (MCP) server for wtp (Worktree Plus), written in Rust. It lets AI assistants manage Git worktrees via the wtp CLI. The wtp mcp mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 9 defined tools rather than through you.

What it actually does

  • Safety defaults — Hooks and branch deletion are disabled by default and must be explicitly enabled
  • Rich resources — Query worktree lists, resolved paths, grouped views, and repo overview

Adding it to your client

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Its toolset

Everything the assistant can do here goes through one of these:

  • list-worktrees — List all worktrees in the repository
  • add-worktree — Create a new worktree for an existing or new branch
  • remove-worktree — Remove a worktree (optionally with its branch)
  • merge-worktree — Return a git merge command for a worktree branch
  • init-config — Initialize wtp configuration in the repository
  • get-worktree-path — Get the absolute path to a worktree
  • shell-hook — Get shell hook script (bash/zsh/fish)
  • shell-init — Get shell initialization script (bash/zsh/fish)
  • Homebrew — The Homebrew tool exposed by this server

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 9 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Wtp MCP.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the wtp mcp mcp server does with a few real requests.

When to reach for it

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Wtp MCP's toolset — list-worktrees, add-worktree, remove-worktree and 6 more — is a fair guide to whether it matches your workflow. It is maintained by bnomei; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
list-worktreesList all worktrees in the repository
add-worktreeCreate a new worktree for an existing or new branch
remove-worktreeRemove a worktree (optionally with its branch)
merge-worktreeReturn a git merge command for a worktree branch
init-configInitialize wtp configuration in the repository
get-worktree-pathGet the absolute path to a worktree
shell-hookGet shell hook script (bash/zsh/fish)
shell-initGet shell initialization script (bash/zsh/fish)
HomebrewThe Homebrew tool exposed by this server.

How to install the Wtp MCP MCP server

```json
{
  "mcpServers": {
    "wtp": {
      "command": "wtp-mcp-rs"
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use Wtp MCP to list-worktrees.
  • Use Wtp MCP to add-worktree.
  • Use Wtp MCP to remove-worktree.

Frequently asked questions

It connects Wtp MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 9 tools (list-worktrees, add-worktree, remove-worktree, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Wtp MCP directly.