%20--%3e%3cdefs%3e%3cstyle%3e%20.st0%20{%20fill:%20%23061b40;%20}%20.st1%20{%20fill:%20%23306af1;%20}%20.st2%20{%20fill:%20%235ce5cf;%20}%20%3c/style%3e%3c/defs%3e%3cg%3e%3cpath%20class='st0'%20d='M55,10.5h9v3h-9v9h12V7.5h-12v3ZM64,19.5h-6v-3h6v3Z'/%3e%3cpolygon%20class='st0'%20points='69%2016.5%2078%2016.5%2078%2019.5%2069%2019.5%2069%2022.5%2081%2022.5%2081%2013.5%2072%2013.5%2072%2010.5%2081%2010.5%2081%207.5%2069%207.5%2069%2016.5'/%3e%3cpolygon%20class='st0'%20points='95%2010.5%2095%207.5%2083%207.5%2083%2022.5%2095%2022.5%2095%2019.5%2086%2019.5%2086%2016.5%2095%2016.5%2095%2013.5%2086%2013.5%2086%2010.5%2095%2010.5'/%3e%3cpath%20class='st0'%20d='M40,1.5v21h11.6l1.4-1.4v-7.6h0c0,0-1.4-1.5-1.4-1.5l1.4-1.4V2.9l-1.4-1.4h-11.6ZM50,19.5h-7v-6h7v6ZM50,10.5h-7v-6h7v6Z'/%3e%3c/g%3e%3cpath%20class='st1'%20d='M23.1,24L14.7,4.8l-4.9,11.2h3.8l-1.8,4H3.3L12.1,0H2C.9,0,0,.9,0,2v20c0,1.1.9,2,2,2h21.1Z'/%3e%3cpath%20class='st2'%20d='M34,0h-16.8l10.6,24h6.2c1.1,0,2-.9,2-2V2C36,.9,35.1,0,34,0ZM32.5,20h-4V4h4v16Z'/%3e%3c/svg%3e)
Claude Code Iterm Worktree MCP
An MCP service for managing Git worktrees integrated with iTerm2, providing functions such as worktree creation, closing, navigation, and intelligent tab detection to optimize the multi - branch development process.
rating : 2.5 points
downloads : 5.2K
What is the iTerm2 Worktree MCP Server?
This is a Model Context Protocol (MCP) server that helps developers manage Git worktrees through the iTerm2 terminal. It can create, close, and switch worktrees, and automatically open new tabs in iTerm2.How to use the iTerm2 Worktree MCP Server?
After adding the MCP server via Claude Code, you can use commands to create, close, and switch worktrees. The server will automatically detect worktree tabs in iTerm2 and provide navigation functionality.Applicable scenarios
Suitable for developers who need to handle multiple Git branches simultaneously. It can create independent worktrees for each feature and provide intuitive tab management in iTerm2.Main features
Create a worktree
Create a new Git worktree based on the specified feature name, branch name, and folder, and open a new tab in iTerm2.
Close a worktree
After ensuring that the worktree has committed and pushed changes, safely close and clean up the worktree.
Open a worktree
Open an existing worktree in a new iTerm2 tab, supporting forced overwriting of existing tabs.
Switch worktrees
Quickly switch to the iTerm2 tab of a specific worktree, supporting selection by name or tab ID.
Display active worktrees
List all running worktrees and their corresponding iTerm2 tab information.
Intelligent tab detection
Without relying on metadata files, analyze the working directories of iTerm2 tabs in real - time to discover worktrees.
Advantages
Improve work efficiency: Reduce the time for manual worktree management through automated operations.
Enhance user experience: Deeply integrate with iTerm2 to provide more intuitive tab management.
Isolate development environments: Each worktree is independent, avoiding interference between different branches.
Limitations
Requires support from iTerm2 and Claude Code.
Not applicable to projects without Git configuration.
May require a certain learning curve for novice users.
How to use
Install the MCP server
Use the Claude Code command to add the iTerm2 Worktree MCP server to your environment.
%20--%3e%3cdefs%3e%3cstyle%3e%20.st0%20{%20fill:%20%230080ff;%20}%20%3c/style%3e%3c/defs%3e%3cpath%20class='st0'%20d='M16.2,11.1c.4.5.4,1.2,0,1.8l-4.7,7.1h-3.8l5.3-8L7.6,4h3.8l4.7,7.1Z'/%3e%3c/svg%3e)
Create a worktree
Create a new worktree by specifying the feature name, branch name, and worktree folder.
View active worktrees
Use the `activeWorktrees` command to view all current worktrees and their associated iTerm2 tabs.
Switch worktrees
Use the `switchToWorktree` command to quickly switch to the tab of a specific worktree.
Close a worktree
After confirming that the worktree has committed and pushed changes, use the `closeWorktree` command to close and clean up the worktree.
Usage examples
Create a worktree for a new feature
When developing a new feature, create an independent worktree to avoid affecting the main branch.
Switch back to the worktree of an old feature
After completing the current feature, quickly switch back to the previous worktree to continue development.
Close a completed worktree
After completing a feature, safely close the worktree and clean up resources.
Frequently Asked Questions
What tools are required to support this MCP server?
How do I know if my worktree has been created correctly?
If I close a worktree, can I restore it?
Can I use the same worktree in different iTerm2 windows?
Related resources
GitHub source code
Source code and documentation for the iTerm2 Worktree MCP Server
Claude Code official documentation
Official usage guide and API documentation for Claude Code
iTerm2 official documentation
Detailed usage instructions and configuration guide for iTerm2
Markdownify MCP
Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.
TypeScript
30.7K
5 points
Gitlab MCP Server
Certified
The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.
TypeScript
21.4K
4.3 points
Notion Api MCP
Certified
A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.
Python
19.4K
4.5 points
Duckduckgo MCP Server
Certified
The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.
Python
63.7K
4.3 points
Unity
Certified
UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.
C#
28.5K
5 points
Figma Context MCP
Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.
TypeScript
58.8K
4.5 points
Minimax MCP Server
The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.
Python
43.3K
4.8 points
Gmail MCP Server
A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.
TypeScript
20.4K
4.5 points