Terminal MCP Server

What is Terminal MCP Server?

Terminal MCP Server is a Model Context Protocol (MCP) server that enables Claude Desktop to execute terminal commands, navigate directories, and retrieve terminal environment information. It is designed for developers who want to interact with their local terminal directly through Claude.

How to use Terminal MCP Server?

Clone the repository, install dependencies (npm install), and build the project (npm run build). Then add the server configuration to your Claude Desktop configuration file (e.g., ~/Library/Application Support/Claude/claude_desktop_config.json on macOS) with the correct path and the environment variable PERMISSION_REQUIRED: "true". After restarting Claude Desktop, you can ask Claude to run commands such as checking directory contents or changing folders.

Key features of Terminal MCP Server

• Execute any terminal command with arguments and options.
• Navigate directories while maintaining state between commands.
• Get the current working directory path.
• Retrieve terminal environment information (shell, user, platform).
• Full output capture (stdout, stderr, exit codes).
• Proper error handling and formatting.

Use cases of Terminal MCP Server

• Quickly list files in a directory without leaving Claude Desktop.
• Change to a specific folder and continue executing commands there.
• Retrieve terminal environment details during a conversation.
• Execute system commands while maintaining session state.

FAQ from Terminal MCP Server

What dependencies are required to run Terminal MCP Server?

Node.js v18 or higher, TypeScript, and Claude Desktop are required.

How is Terminal MCP Server configured for Claude Desktop?

Add a JSON entry to the Claude Desktop configuration file (claude_desktop_config.json) with the command, args pointing to the built dist/index.js, and an environment variable PERMISSION_REQUIRED set to "true".

What security measures does Terminal MCP Server implement?

It requires explicit user permission through Claude Desktop, allows controlling environment variables via configuration, and includes timeouts and error handling for command execution.

What tools does Terminal MCP Server provide?

Four tools are available: execute_command, change_directory, get_current_directory, and get_terminal_info.