Skip to main content
Glama

Hotkeyless AHK MCP and Skills

License: MIT AHK Version MCP Claude Support OpenCode Support Github Copilot Support

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

  1. MCP server

  1. Agent skills


Related 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 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 /list returns 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

  1. Copy the ./skills/.opencode/... folders to

  • .opencode/skills for project specific skill setup

  • %USERPROFILE%/.config/opencode/skills for global setup

  1. You can adjust AGENTS.md, custom subagents or custom commands to reference the skills

  2. Restart your OpenCode (CLI or Desktop)

  3. When asking the agent to use the "hotkeyless AHK skills" it should now use the skill guide

ClaudeCode

  1. Copy the ./skills/.claude/... folders to

  • .claude/skills for project specific skill setup

  • %USERPROFILE%/.config/claude-code/skills for global setup

  1. You can adjust CLAUDE.md, custom subagents or custom commands to reference the skills

  2. Restart your Claude Code

  3. When asking the agent to use the "hotkeyless AHK skills" it should now use the skill guide

Github Copilot

  1. Copy the ./skills/.claude/... folders to

  • .claude/skills for project specific skill setup

  • %USERPROFILE%/.config/claude-code/skills for global setup

  1. You can adjust AGENTS.md, custom subagents or custom commands to reference the skills

  2. Restart your Claude Code

  3. When asking the agent to use the "hotkeyless AHK skills" it should now use the skill guide


License

MIT

Available Tools

4 tools
discover_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

    A3.7/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tools use a consistent verb_noun pattern with snake_case: discover_commands, mouse_move, send_keys, trigger_command. No deviations.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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
      -