Which integrations are available for this server?

Provides git worktree management capabilities, including creating new worktrees with feature branches, closing worktrees after verifying they're clean and pushed, and listing active worktrees. Integrates with iTerm2 terminal to open worktrees in new tabs, switch between tabs containing worktrees, and detect which tabs are running specific worktrees across different windows.

How do I use iTerm2 Worktree MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@iTerm2 Worktree MCP Server create a new worktree for the authentication feature" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

iTerm2 Worktree MCP Server

A Model Context Protocol (MCP) server that automates git worktree management with iTerm2 integration for Claude Code.

https://github.com/user-attachments/assets/16188878-8fe8-450c-b2a3-cfd617d74f43

Installation

Add to Claude Code:

claude mcp add -s user worktree -- python3 path/to/worktree_mcp_server.py

Related MCP server: GitHub MCP Tools

Features

Core Worktree Management

Create Worktree: Creates a new git worktree with a feature branch and opens it in a new iTerm2 tab
Close Worktree: Safely closes worktrees after verifying they're clean and pushed
Open Worktree: Opens an existing worktree in a new iTerm2 tab (with force option to override if already open)

Active Worktrees: Lists all git worktrees and shows which iTerm2 tabs they're running in
Switch to Worktree: Quickly switch to a worktree's iTerm2 tab by name or specific tab ID

Smart Tab Detection

Dynamic Discovery: No metadata files - finds tabs by analyzing their working directories in real-time
Multi-Tab Support: Shows all tabs running the same worktree across different windows
Window Context: Identifies which tabs are in the current window with thisWindow flag

Available Tools

Tool	Description	Parameters
`createWorktree`	Create new worktree + branch, open in iTerm2 tab	`feature_name`, `branch_name`, `worktree_folder`, `description`, `start_claude?`
`closeWorktree`	Validate, close, and cleanup worktree	`worktree_name`
`activeWorktrees`	List all worktrees and their iTerm2 tabs	None
`switchToWorktree`	Switch to worktree's iTerm2 tab	`worktree_name`, `tab_id?`
`openWorktree`	Open existing worktree in new tab	`worktree_name`, `force?`

Workflow

Create: createWorktree - Specify feature name, branch name, and worktree folder - automatically creates the worktree and switches to a new iTerm2 tab
Navigate: switchToWorktree or openWorktree - Seamlessly move between worktrees
Monitor: activeWorktrees - See all worktrees and their active tabs
Develop: Work in isolated worktree environments with full iTerm2 integration
Close: closeWorktree - Verify changes are committed and pushed, then safely remove the worktree