Summary
This server bridges Claude to AutoHotkey desktop automation through the Hotkeyless AHK HTTP API. It exposes tools to list available AHK commands and trigger them with parameters, letting you automate Windows workflows without writing hotkey bindings. You get configurable blacklists to block dangerous commands, request timeouts, and command list caching. Useful when you want Claude to control desktop applications, simulate keystrokes, or orchestrate GUI interactions on Windows machines where you've already set up Hotkeyless AHK commands. The package ships as a stdio transport server via npx, with environment variables for the API base URL, timeout limits, and endpoint paths.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Hotkeyless AHK MCP and Skills
This repository provides:
- A TypeScript MCP server that wraps the Hotkeyless AHK HTTP API.
- Reusable skill documents for OpenCode, Claude, and generic agent runtimes.
- Practical examples for desktop automation scenarios.
Workspace layout
packages/
mcp-server/ # Node MCP server package
skills/ # Agent skill documents
examples/ # End-to-end usage examples
MCP server
Quick start
OpenCode
opencode.json:
{
...
"mcp": {
...
"hotkeyless-ahk": {
"type": "local",
"command": ["npx", "-y", "@tim0_12432/hotkeyless-ahk-mcp-server"],
"enabled": true,
"environment": {
"BLACKLIST": "shutdown,restart,kill"
...
}
}
},
...
}
ClaudeCode
.mcp.json:
{
"mcpServers": {
...
"hotkeyless-ahk": {
"command": "npx",
"args": ["-y", "@tim0_12432/hotkeyless-ahk-mcp-server"],
"env": {
"BLACKLIST": "shutdown,restart,kill"
...
}
}
}
}
Github Copilot
mcp-config.json:
{
...
"mcpServers": {
...
"hotkeyless-ahk": {
"type": "local",
"command": "npx",
"args": ["-y", "@tim0_12432/hotkeyless-ahk-mcp-server"],
"env": {
"BLACKLIST": "shutdown,restart,kill"
...
},
"tools": ["*"]
}
},
...
}
Build from source
Follow instructions here.
1. Build server
bun install
bun run build
npm should also work without problems!
2. Setup your harness
OpenCode
opencode.json:
{
...
"mcp": {
...
"hotkeyless-ahk": {
"type": "local",
"command": ["node", "<absolute path to the built files>/mcp-server/dist/index.js"],
"enabled": true,
"environment": {
"BLACKLIST": "shutdown,restart,kill"
...
}
}
},
...
}
ClaudeCode
.mcp.json:
{
"mcpServers": {
...
"hotkeyless-ahk": {
"command": "node",
"args": ["<absolute path to the built files>/mcp-server/dist/index.js"],
"env": {
"BLACKLIST": "shutdown,restart,kill"
...
}
}
}
}
Github Copilot
mcp-config.json:
{
...
"mcpServers": {
...
"hotkeyless-ahk": {
"type": "local",
"command": "node",
"args": ["<absolute path to the built files>/mcp-server/dist/index.js"],
"env": {
"BLACKLIST": "shutdown,restart,kill"
...
},
"tools": ["*"]
}
},
...
}
Hotkeyless AHK API contract
GET /listreturns JSON array of{ command: string, note: string }GET /send/<command>accepts query parameters
Configuration
Default config is at mcp-server/dist/infrastructure/config/config.ts.
Environment overrides:
| Parameter override | What it does | Default |
|---|---|---|
| BASE_URL | Adress of the Hotkeyless AHK server | http://localhost:42800 |
| TIMEOUT_MS | Timeout milliseconds for each request | 4000 |
| BLACKLIST | A list of commands to avoid being called | [] |
| CACHE_TTL_MS | Cache lifetime for command list in milliseconds | 5000 |
| ENDPOINT_LIST | Endpoint address of the command list | /list |
| ENDPOINT_TRIGGER | Endpoint address for invoking commands | /send |
Agent Skills
Quick start
OpenCode
- Copy the
./skills/.opencode/...folders to
.opencode/skillsfor project specific skill setup%USERPROFILE%/.config/opencode/skillsfor global setup
- You can adjust AGENTS.md, custom subagents or custom commands to reference the skills
- Restart your OpenCode (CLI or Desktop)
- When asking the agent to use the "hotkeyless AHK skills" it should now use the skill guide
ClaudeCode
- Copy the
./skills/.claude/...folders to
.claude/skillsfor project specific skill setup%USERPROFILE%/.config/claude-code/skillsfor global setup
- You can adjust CLAUDE.md, custom subagents or custom commands to reference the skills
- Restart your Claude Code
- When asking the agent to use the "hotkeyless AHK skills" it should now use the skill guide
Github Copilot
- Copy the
./skills/.claude/...folders to
.claude/skillsfor project specific skill setup%USERPROFILE%/.config/claude-code/skillsfor global setup
- You can adjust AGENTS.md, custom subagents or custom commands to reference the skills
- Restart your Claude Code
- When asking the agent to use the "hotkeyless AHK skills" it should now use the skill guide
License
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
BASE_URLThe base URL of the Hotkeyless AHK HTTP server.
TIMEOUT_MSThe timeout in milliseconds for requests to the server.
BLACKLISTA comma-separated list of blacklisted commands.
CACHE_TTL_MSThe time-to-live in milliseconds for cached responses.
ENDPOINT_LISTThe default endpoint path for listing commands.
ENDPOINT_TRIGGERThe default endpoint path for triggering commands.
Registryactive
Package@tim0_12432/hotkeyless-ahk-mcp-server
TransportSTDIO
UpdatedApr 27, 2026