Hotkeyless AHK MCP
Allows interaction with a Hotkeyless AHK HTTP API to execute AutoHotkey commands for desktop automation, such as sending keystrokes, controlling windows, and running scripts.
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 examplesRelated MCP server: Desktop Commander MCP Server
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
1. Build server
bun install
bun run buildnpm 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 |
|
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 |
|
ENDPOINT_TRIGGER | Endpoint address for invoking commands |
|
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
Available Tools
4 toolsdiscover_commandsB
Fetch available Hotkeyless commands from /list.
Inputs: refresh.
mouse_moveB
Move mouse cursor via optional /mouse_move endpoint. Returns clear error when endpoint is unsupported.
Inputs: x (required), y (required).
send_keysB
Send keystrokes through optional /send_keys endpoint. Returns clear error when endpoint is unsupported.
Inputs: keys (required).
trigger_commandA
Trigger one Hotkeyless command by exact name using /trigger. Enforces blacklist and verifies command exists.
Inputs: command (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a distinct purpose: discover_commands fetches available commands, mouse_move moves the cursor, send_keys sends keystrokes, and trigger_command executes a command. No overlap exists.
All tools use a consistent verb_noun pattern with snake_case: discover_commands, mouse_move, send_keys, trigger_command. No deviations.
With 4 tools, the count is well-scoped for the specific domain of Hotkeyless AHK automation. It covers the core functionality without being too sparse or excessive.
The tool surface covers the essential operations: listing commands, moving mouse, sending keys, and triggering commands. No obvious gaps for the intended purpose, as optional endpoints are handled with clear errors.
Maintenance
Related MCP Connectors
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Host any HTTP API as a standard MCP server; auto-distribute to 12+ mainstream agent platforms.
MCP server for AI dialogue using various LLM models via AceDataCloud
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
- AlicenseBqualityCmaintenanceAutoHotkey v2 MCP Server with prompts, tool chains, debugging, and code execution.3246MIT
- AlicenseNot gradedqualityDmaintenanceA comprehensive MCP server that gives AI assistants full control over your desktop — monitor system resources, manage windows, capture screenshots, control the clipboard, launch applications, and more.MIT
- FlicenseNot gradedqualityDmaintenanceA lightweight MCP HTTP server giving AI assistants real tools to interact with your Windows machine, including running commands, file access, system info, web search, and browser automation.1-
- FlicenseNot gradedqualityDmaintenanceA local, dependency-free MCP server that gives AI agents controlled access to the active Windows desktop, enabling automated interaction with applications through screenshots, clicks, typing, and window management.1-