ahk-mcp

What is ahk-mcp?

ahk-mcp is an MCP server that exposes AutoHotkey functionality, enabling AI models to perform Windows automation tasks such as window enumeration, keyboard/mouse control, Windows API interrogation, screen capture with OCR, and window manipulation. It is designed for developers and users who want to automate Windows tasks through AI interfaces.

How to use ahk-mcp?

Assuming you have the mcp CLI set up, you can install the server in Claude Desktop by running mcp install main.py. The server depends on ahk-binary, the ahk library, mss, easyocr, and numpy. It only works on Windows. For detailed documentation, exploring the source code in main.py is encouraged.

Key features of ahk-mcp

• Enumerates windows and applications
• Controls keyboard and mouse (typing, clicking)
• Interrogates Windows APIs via AutoHotkey
• Performs screen capture and OCR
• Gets accurate window positioning and monitor context
• Exposes 33 automation tools in total

Use cases of ahk-mcp

• Automating repetitive Windows tasks via AI assistants
• Extracting text from windows that don't expose text properly
• Manipulating window positions across multiple monitors
• Controlling keyboard and mouse inputs programmatically

FAQ from ahk-mcp

What operating system does ahk-mcp support?

The server only works on Windows.

What dependencies does ahk-mcp require?

It depends on ahk-binary for AutoHotkey executables, the ahk project for interfacing with AutoHotkey, and mss, easyocr, and numpy for OCR functionality.

How many tools does ahk-mcp provide?

The server currently exposes 33 tools covering window enumeration, keyboard/mouse control, Windows APIs, screen capture & OCR, window positioning, and window manipulation.

Where can I find documentation for the tools?

While documentation is being worked on, exploring the source code in main.py is recommended.

How do I install ahk-mcp for Claude Desktop?

Assuming the mcp CLI is set up, run mcp install main.py to install the server in Claude Desktop.