About Ahk MCP
Ahk MCP is an MCP server published by spyoungtech in the AI category: mCP server exposing AutoHotkey functionality, enabling model interfaces to automation tasks on Windows.
The repository has 21 stars and 7 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/spyoungtech/ahk-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Ahk MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 5 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
ahk-mcp
MCP server exposing AutoHotkey functionality, enabling model interfaces to automation tasks on Windows.
This server only works on Windows and provides the following tools to your AI:
- Ability to enumerate windows/applications
- Ability to control keyboard/mouse (typing, clicking, etc)
- Ability to interrogate Windows APIs (via AutoHotkey) about windows (e.g., to get the text of a window, the position of its GUI controls, etc.)
- Screen capture & OCR functionality (useful when text is not exposed properly by Windows APIs/controls)
- Ability to get accurate window positioning and contextual information about computer monitors (e.g., know what windows are on your primary/secondary monitors)
- Ability to manipulate windows and other actions via AutoHotkey
In total, there are 33 tools currently exposed by the server, the above is just a simple overview.
While we work on documentation, exploring the source code in main.py is encouraged!
Usage
This project makes use of the Python MCP SDK with FastMCP. Please see the Python MCP SDK repo and documentation for detailed information.
Assuming you've already setup mcp CLI, you can install this MCP service in Claude Desktop with a simple mcp command:
mcp install main.py
This project depends on ahk-binary to provide the required AutoHotkey executables and the ahk
project to interface with AutoHotkey. It uses mss, easyocr, and numpy
for OCR functionality.
Contributing
The best way to contribute is right here on GitHub. Please feel free to open an issue to get started. Pull requests are also welcome, but it is strongly recommended to open an issue first, especially for significant changes.
README fetched from the repository 5 days ago. The original is authoritative.