iTerm MCP Server

by rishabkoul
ISC License
251
  • Apple

Integrations

  • Allows AI assistants to create and manage iTerm2 terminal sessions, execute commands, read terminal output, list active terminals, and close terminals.

  • Provides terminal integration capabilities specifically for macOS systems through iTerm2 terminal application.

ITerm MCP Server

A Model Context Protocol (MCP) server implementation for iTerm2 terminal integration. This server allows AI assistants to interact with iTerm2 terminals through the Model Context Protocol.

Features

  • Create and manage iTerm2 terminal sessions
  • Execute commands in terminals
  • Read terminal output
  • List active terminals
  • Close terminals

Requirements

  • Node.js >= 14.x
  • iTerm2
  • macOS (since iTerm2 is macOS-only)

Configuration

Standard Configuration

The server uses the standard MCP configuration options. No additional configuration is required.

Cursor Configuration

To use this server with Cursor, add the following configuration to your ~/.cursor/mcp.json file:

{ "mcpServers": { "terminal": { "command": "npx", "args": ["iterm_mcp_server"] } } }

Tools

  • open_terminal: Open a new terminal instance
  • execute_command: Execute a command in a specific terminal
  • read_output: Read the output from a specific terminal
  • close_terminal: Close a specific terminal
  • list_terminals: List all active terminals and their information

Security Considerations

  • The server validates all input using Zod schemas
  • Commands are executed in isolated terminal sessions
  • Proper error handling and input sanitization is implemented

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

ISC

Author

Rishab Koul

-
security - not tested
A
license - permissive license
-
quality - not tested

A Model Context Protocol server that enables AI assistants to interact with iTerm2 terminals, allowing creation and management of terminal sessions, command execution, and reading terminal output.

  1. Features
    1. Requirements
      1. Configuration
        1. Standard Configuration
        2. Cursor Configuration
      2. Tools
        1. Security Considerations
          1. Contributing
            1. License
              1. Author

                Related MCP Servers

                • -
                  security
                  F
                  license
                  -
                  quality
                  A Model Context Protocol server that provides persistent task management capabilities for AI assistants, allowing them to create, update, and track tasks beyond their usual context limitations.
                  Last updated a month ago
                  1
                  TypeScript
                • -
                  security
                  F
                  license
                  -
                  quality
                  A comprehensive Model Context Protocol server implementation that enables AI assistants to interact with file systems, databases, GitHub repositories, web resources, and system tools while maintaining security and control.
                  Last updated 2 months ago
                  16
                  TypeScript
                • -
                  security
                  -
                  license
                  -
                  quality
                  A Model Context Protocol server that gives AI models access to your iTerm terminal session, allowing them to read output, write commands, and send control characters.
                  Last updated 3 months ago
                  TypeScript
                  MIT License
                • A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that provides programmatic access to the Windows terminal, enabling AI models to interact with the Windows command line through standardized tools for writing commands, reading output, and sending control signals.
                  Last updated 2 months ago
                  3
                  JavaScript
                  MIT License

                View all related MCP servers

                ID: hs9yuysxwl