HotkeylessAHK-mcp-skill

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.

packages/
  mcp-server/   # Node MCP server package
  skills/       # Agent skill documents
examples/       # End-to-end usage examples

---

1. MCP server

• Quick start
• Hotkeyless AHK API contract
• Configuration

1. Agent skills

• Quick start

---

bun install
bun run build

npm should also work without problems!

`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"
          ...
      }
    }
  },
  ...
}

`.mcp.json`:

{
  "mcpServers": {
    ...
    "hotkeyless-ahk": {
      "command": "node",
      "args": ["<absolute path to the built files>/mcp-server/dist/index.js"],
      "env": {
        "BLACKLIST": "shutdown,restart,kill"
        ...
      }
    }
  }
}

`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": ["*"]
    }
  },
  ...
}

• GET /list returns JSON array of { command: string, note: string }
• `GET /