Model Context Protocol for Windows automation using AutoHotkey
Project description
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.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file iflow_mcp_spyoungtech_ahk_mcp-0.1.0.tar.gz.
File metadata
- Download URL: iflow_mcp_spyoungtech_ahk_mcp-0.1.0.tar.gz
- Upload date:
- Size: 5.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e569c31f055a978d90b5287770021237955c07a25f4759c4edf50c66404809df
|
|
| MD5 |
044f42eed9a2f561d44068fa547e4f98
|
|
| BLAKE2b-256 |
d5fff0aa99618770600971e8d561b613b681bb8bbfc7f5df6295c9c2fbf49f44
|
File details
Details for the file iflow_mcp_spyoungtech_ahk_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: iflow_mcp_spyoungtech_ahk_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 6.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.0 {"installer":{"name":"uv","version":"0.10.0","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ecb09894f81916e2a4f0e43c629ce3bcde82d49eeda8bf783ec31c72d459dd8b
|
|
| MD5 |
6613654ef6dd48d60ef01da05d341d1f
|
|
| BLAKE2b-256 |
da02e448afc3b33c1565fb1f511116c8b2f7e6e17b1df832909b7268bdac78d7
|
