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.