What is iterm-mcp?
iterm-mcp is a MCP server by ferrislucas that access iTerm: run commands and ask questions about what is shown in the terminal. It is listed under Developer tools and has 570 GitHub stars.
| Type | Mcp server |
|---|---|
| Author | ferrislucas |
| Repository | ferrislucas/iterm-mcp |
| Popularity | 570 GitHub stars |
| Category | Developer tools |
| Security | Review before installing (68/100) |
| Rank | #237 of 4,418 MCP servers; #84 in Developer tools |
| License | MIT |
| Last commit | 2025-09-20 |
| Stars this week | +2 |
| Runs | Not stated |
Is iterm-mcp safe to install?
iterm-mcp scores 68/100 on the MCPMods security check: Review before installing. Things to review: can take actions such as send, write or deploy; executes code or shell commands. It passed 2 of 6 checks.
MCP server results come from listing signals: who publishes it, where your data goes and what it can do. The code itself is not scanned yet.
| Check | Result |
|---|---|
| Community-built server | Note |
| Where data goes is not stated | Note |
| No credentials mentioned | Pass |
| Can take actions such as send, write or deploy | Review |
| Executes code or shell commands | Review |
| Source on GitHub | Pass |
How do I install iterm-mcp?
- Find the launch command. The README says how the server starts (npx, uvx, docker or a remote URL) and which API keys it needs.
https://github.com/ferrislucas/iterm-mcp
- Add it to Claude Code. Replace the part after -- with the command from the README. Remote servers use --transport http with a URL.
claude mcp add iterm-mcp -- <command from README> claude mcp add --transport http iterm-mcp <server-url>
- Check it connected. This lists your MCP servers and their status.
claude mcp list
Or ask Claude to set it up
Paste this into Claude Code and it installs iterm-mcp for you:
Add the "iterm-mcp" MCP server from https://github.com/ferrislucas/iterm-mcp to Claude Code. Read its README for the launch command and any API keys I need, run claude mcp add, then check that it connects.