auto-claude

A CLI tool to automatically approve Claude Desktop App tool requests

Requirements

• Python 3.11 or newer
• Claude Desktop App (macOS or Windows)

Installation

From PyPI with uv

uv tool install auto-claude

This is the recommended way for most users.

From source (for developers)

uv run src/auto_claude/auto_claude.py

Use this if you want to develop or modify the project locally.

Normal Usage

auto-claude

Or specify a port if you must:

auto-claude [port]

Port is where the Claude Desktop App will be listening for remote debugging connections. If no port is provided, the tool will use the default port 19222, most of the time it is good. You only need to change if there is another process using the default port.

• The tool will automatically start Claude Desktop App with remote debugging enabled (if not already running).
• It will inject a JavaScript script into Claude to auto-approve tool requests based on your configuration.
• Supported platforms: macOS and Windows

How it works

• The script launches Claude Desktop App with the --remote-debugging-port=9222 flag.
• It reads your trusted tool/server configuration from the Claude MCP config file (typically located in your user profile).
• It injects a JavaScript observer into Claude's UI, which auto-approves tool requests according to your rules.
• Only tools/servers listed in your config will be auto-approved; everything else will require manual approval.

Configuration

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

Config file locations:

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

You can edit this file directly or via the Claude Desktop App settings.

Example config

{
  "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 ...
  }
}

Features

• Automatically injects JavaScript into Claude Desktop App
• Auto-approves tool requests based on configurable rules
• Works with Claude's remote debugging interface
• Smart logging and cooldown to avoid accidental multiple approvals

License

MIT