Claude Autoapprove

🚀 claude-autoapprove

A command-line tool for automatically approving tool requests in the Claude desktop application.

If you prefer a more user-friendly approach, consider using claude_autoapprove_mcp.

🚀 Quick Start

✨ Features

• Automatically injects a JavaScript script into the Claude desktop application.
• Automatically approves tool requests based on configuration rules.
• Utilizes Claude's remote debugging interface.
• Implements intelligent logging and a cooling mechanism to avoid accidental multiple approvals.

📦 Installation

Install from PyPI

pip install claude-autoapprove

This is the recommended installation method for most users.

Install from source code (for developers)

pip install -e .

Use this command if you need to develop or modify the project.

💻 Usage Examples

Basic Usage

claude-autoapprove [port]

The port is the port on which the Claude desktop application listens for remote debugging connections. If no port is specified, the default 19222 will be used, which is a good choice in most cases. You only need to change it if the default port is occupied by another process.

• The tool will automatically start the Claude desktop application and enable remote debugging (if it's not running).
• It injects a JavaScript script into Claude to automatically approve tool requests according to your configuration.
• Supported platforms: macOS and Windows

🔧 Technical Details

How it works

• The script starts the Claude desktop application with the --remote-debugging-port=9222 flag.
• It reads the configuration from your trusted tools/servers configuration file (usually located in the user profile directory).
• It injects a JavaScript observer into Claude's UI to automatically approve tool requests according to the rules.
• Only tools/servers listed in your configuration will be automatically approved; all other requests require manual approval.

Configuration

The list of trusted tools and servers is read from the claude_desktop_config.json file (usually in the mcpServers section, autoapprove list).

Configuration file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

You can edit this file directly or configure it through the Claude desktop application settings.

Configuration example

{
  "mcpServers": {
    "fetch": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "mcp/fetch", "--ignore-robots-txt", "--user-agent=\"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36\""],
      "autoapprove": ["fetch"]
    },
    "brave-search": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "BRAVE_API_KEY", "mcp/brave-search"],
      "env": {"BRAVE_API_KEY": "..."},
      "autoapprove": ["brave_local_search", "brave_web_search"]
    }
    // ... more servers ...
  }
}

⚠️ Important Note

The remote debugging port allows any application on your local host (your computer) to connect to the running Claude desktop application and execute arbitrary code in this context. This could be used for malicious purposes. The risk is lower if you know what's running on your computer.

Therefore, please pay special attention to the security of the remote debugging port.

📄 License

The project uses [Insert license information].

💡 Contribution

If you want to contribute to this project, you can participate in the following ways:

• Submit issue reports.
• Create pull requests.
• Provide feedback and suggestions.