AIbase
EN
Explore
Claude Code Iterm Worktree MCP
C

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.
Developer toolsVersion control#Git worktree#iTerm2 integration#Branch management#Terminal navigation.Python
2.5 points
2

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 worktreeCreate a new Git worktree based on the specified feature name, branch name, and folder, and open a new tab in iTerm2.
Close a worktreeAfter ensuring that the worktree has committed and pushed changes, safely close and clean up the worktree.
Open a worktreeOpen an existing worktree in a new iTerm2 tab, supporting forced overwriting of existing tabs.
Switch worktreesQuickly switch to the iTerm2 tab of a specific worktree, supporting selection by name or tab ID.
Display active worktreesList all running worktrees and their corresponding iTerm2 tab information.
Intelligent tab detectionWithout relying on metadata files, analyze the working directories of iTerm2 tabs in real - time to discover worktrees.

Advantages and limitations

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.
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 featureWhen developing a new feature, create an independent worktree to avoid affecting the main branch.
Switch back to the worktree of an old featureAfter completing the current feature, quickly switch back to the previous worktree to continue development.
Close a completed worktreeAfter 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
Installation
Copy the following command to your Client for configuration
Note: Your key is sensitive information, do not share it with anyone.
Z
Zen MCP Server
Zen MCP is a multi-model AI collaborative development server that provides enhanced workflow tools and cross-model context management for AI coding assistants such as Claude and Gemini CLI. It supports seamless collaboration of multiple AI models to complete development tasks such as code review, debugging, and refactoring, and can maintain the continuation of conversation context between different workflows.
Python
18
5 points
C
Container Use
Container Use is an open-source tool that provides a containerized isolated environment for coding agents, supporting parallel development of multiple agents without interference.
Go
12
5 points
S
Search1api
The Search1API MCP Server is a server based on the Model Context Protocol (MCP), providing search and crawling functions, and supporting multiple search services and tools.
TypeScript
376
4 points
D
Duckduckgo MCP Server
Certified
The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.
Python
892
4.3 points
M
MCP Alchemy
Certified
MCP Alchemy is a tool that connects Claude Desktop to multiple databases, supporting SQL queries, database structure analysis, and data report generation.
Python
361
4.2 points
P
Postgresql MCP
A PostgreSQL database MCP service based on the FastMCP library, providing CRUD operations, schema inspection, and custom SQL query functions for specified tables.
Python
147
4 points
M
MCP Scan
MCP-Scan is a security scanning tool for MCP servers, used to detect common security vulnerabilities such as prompt injection, tool poisoning, and cross-domain escalation.
Python
659
5 points
A
Agentic Radar
Agentic Radar is a security scanning tool for analyzing and assessing agentic systems, helping developers, researchers, and security experts understand the workflows of agentic systems and identify potential vulnerabilities.
Python
584
5 points
Featured MCP Services
M
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
1.8K
5 points
G
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
154
4.3 points
N
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
201
4.5 points
D
Duckduckgo MCP Server
Certified
The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.
Python
892
4.3 points
F
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
6.7K
4.5 points
U
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#
616
5 points
G
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
335
4.5 points
C
Context7
Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.
TypeScript
5.3K
4.7 points
AIbase
Zhiqi Future, Your AI Solution Think Tank
English简体中文繁體中文にほんご
© 2025AIbase