autoclicker-mcp

A Tkinter auto-clicker GUI and an MCP server that exposes the same functionality as AI-callable tools.

The GUI app clicks the left mouse button either for a fixed duration or continuously.
The MCP server lets Claude (or any MCP client) control the clicker, query the cursor position, and locate UI elements by image or OCR text.

macOS / Linux note: the MCP server uses pyautogui for mouse control on non-Windows platforms, so pyautogui and pillow are required there (see install steps below).

Quick start

# Install core dependency
pip install mcp

# macOS / Linux - also required for mouse control
pip install pyautogui pillow

# Run the GUI (Windows only)
py autoclicker_gui.py

# Run the MCP server (Windows / macOS / Linux)
python mcp_server.py

Related MCP server: openowl

MCP server

What it exposes

Register with VS Code / Claude Desktop

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "autoclicker": {
      "command": "python",
      "args": ["a:/Tools/Automator/mcp_server.py"]
    }
  }
}

Optional dependencies for image / OCR modes

# Image matching
py -m pip install pyautogui pillow

# Confidence-based matching (< 1.0)
py -m pip install opencv-python

# OCR text search
py -m pip install pytesseract pyautogui pillow
winget install --id UB-Mannheim.TesseractOCR -e

GUI - how to use (Windows only)

The Tkinter GUI uses Win32 global hotkeys and is Windows-only. The MCP server works everywhere.

1. Choose mode: Timed or Continuous.

2. Set Clicks per second (max 200).

3. Pick Click target:

   • Current cursor - click wherever the mouse is.

   • Fixed position - click a saved X/Y coordinate.

   • Find image on screen - locate a UI element by screenshot crop.

   • Find text on screen (OCR) - locate text like "Start download".

4. If Timed, set Duration in seconds.

5. Set Start delay (time to switch to another window).

6. Press Start.

Hotkeys

These work even when the app is not focused.

Floating controls

Enable Show floating controls to open a small always-on-top Start/Stop panel in the corner of your screen.

Tests

py -m pytest tests/ -v

All 44 tests run without a display, Tesseract, or pyautogui installed.

Notes

• Windows only (uses Win32 mouse events).

• Click rate is capped at 200 CPS for stability.

• Optional Always-on-top toggle keeps the GUI visible over other windows.