Log inSubmit server
HotkeylessAHK MCP Skill logo

HotkeylessAHK MCP Skill

Connects AI agents to a local Hotkeyless AHK API for discovering and invoking desktop automation commands.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install HotkeylessAHK MCP Skill

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "hotkeylessahk-mcp-skill": {
      "command": "npx",
      "args": [
        "-y",
        "@tim0_12432/hotkeyless-ahk-mcp-server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y @tim0_12432/hotkeyless-ahk-mcp-server

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 8d ago.

Overview

HotkeylessAHK-mcp-skill MCP server connects an MCP-compatible agent to a local Hotkeyless AHK HTTP API. It retrieves the available command list and exposes command invocation through the API's list and send endpoints. Configuration supports the API base URL, request timeout, caching, endpoint paths, and a command blacklist. Reach for it when an agent needs to operate desktop actions already defined in Hotkeyless AHK.

Use cases

  • Discover available Hotkeyless AHK commands
  • Invoke local desktop automation commands
  • Block sensitive commands with a blacklist
  • Connect an agent to a custom Hotkeyless AHK endpoint

Key features

  • Lists available AHK commands and notes
  • Invokes commands through the Hotkeyless AHK API
  • Supports command blacklisting
  • Configurable API URL and endpoint paths
  • Configurable request timeout and list caching
  • Includes agent skill documents

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

7/7 checks healthy over the last 46d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · @tim0_12432/hotkeyless-ahk-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads193Package downloads in the last 30 days.
Last commit2mo agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How HotkeylessAHK MCP Skill works

What HotkeylessAHK-mcp-skill MCP server does

HotkeylessAHK-mcp-skill MCP server acts as a TypeScript MCP wrapper around the Hotkeyless AHK HTTP API. It gives an agent access to the commands exposed by a local Hotkeyless AHK instance rather than implementing desktop automation directly. The repository also includes reusable skill documents for OpenCode, Claude, and generic agent runtimes, plus example material for desktop automation scenarios.

The project is organized into an MCP server package under packages/mcp-server, skill documents under packages/skills, and examples under examples/. The underlying automation depends on the separate Hotkeyless AHK service being available to receive requests.

How it works

The server uses two HTTP operations from the Hotkeyless AHK API. A request to GET /list returns a JSON array containing command names and notes. The server can use that information to expose the available actions to an agent. A request to GET /send/<command> invokes a selected command and accepts query parameters.

By default, the API is expected at http://localhost:42800. The command list is cached for 5,000 milliseconds, and each request times out after 4,000 milliseconds unless configuration overrides change those values. A blacklist can prevent specified commands from being called.

Setup and configuration

The package can be started through npx using @tim0_12432/hotkeyless-ahk-mcp-server. The README provides local MCP configuration examples for OpenCode, Claude Code, and GitHub Copilot. These configurations run the server as a local process and pass settings through the environment.

To build from source, install dependencies with bun install and build with bun run build; the documentation states that npm should also work. The generated entry point is mcp-server/dist/index.js, which can be launched with Node.

Supported environment overrides are:

  • BASE_URL: Hotkeyless AHK server address; defaults to http://localhost:42800.
  • TIMEOUT_MS: request timeout in milliseconds; defaults to 4000.
  • BLACKLIST: commands that the server must avoid calling; defaults to an empty list.
  • CACHE_TTL_MS: command-list cache lifetime; defaults to 5000.
  • ENDPOINT_LIST: command-list path; defaults to /list.
  • ENDPOINT_TRIGGER: command invocation path; defaults to /send.

Tools and capabilities

HotkeylessAHK-mcp-skill provides agent access to the command catalog returned by Hotkeyless AHK and to command triggering through the configured API. The catalog includes each command's string identifier and note. Trigger requests can include query parameters supported by the target API.

The blacklist is useful when some locally available commands should not be exposed for agent use. Custom endpoint and base URL settings allow the server to target a compatible API layout instead of relying on the defaults.

The repository's skill files provide usage guidance for OpenCode, Claude Code, and generic agent setups. They are separate from the MCP transport and must be copied into the relevant skill directories when that workflow is used.

Limitations and notes

Its documented API contract contains only the command-list and command-send endpoints. The available actions therefore depend on commands configured in the connected Hotkeyless AHK instance.

The supplied configuration examples use local process execution and do not document a remote MCP deployment. The README identifies AutoHotkey version 2 and MCP SDK version 1.29.0 in project badges, but it does not specify operating-system support beyond the desktop automation context.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about HotkeylessAHK MCP Skill

HotkeylessAHK-mcp-skill is an MCP server that connects AI agents to a local Hotkeyless AHK HTTP API. Its main tools let agents discover available commands and send commands with query parameters. The repository also provides reusable skill documents for OpenCode, Claude, and generic agent runtimes.

Run it with npx using `@tim0_12432/hotkeyless-ahk-mcp-server` and add that command to your MCP client configuration. Alternatively, install dependencies with `bun install`, build with `bun run build`, and launch `mcp-server/dist/index.js` with Node.

Set environment overrides in the MCP client configuration. `BASE_URL`, `TIMEOUT_MS`, `BLACKLIST`, `CACHE_TTL_MS`, `ENDPOINT_LIST`, and `ENDPOINT_TRIGGER` control the API address, request behavior, blocked commands, cache duration, and endpoint paths.

Yes, Claude Code is documented as a supported setup. Add the server to `.mcp.json`, run it with npx or the built Node entry point, and pass configuration values through the `env` object.

Yes, set the `BLACKLIST` environment variable to a list of commands that should not be called. The default blacklist is empty, so no commands are blocked unless you configure it.

Related MCP servers

All in OS Automation All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewHotkeylessAHK MCP Skill AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/hotkeylessahk-mcp-skill?style=directory)](https://allmcps.com/mcp/hotkeylessahk-mcp-skill)
HTML Embed
<a href="https://allmcps.com/mcp/hotkeylessahk-mcp-skill"><img src="https://allmcps.com/api/badge/hotkeylessahk-mcp-skill?style=directory" alt="HotkeylessAHK MCP Skill on AllMCPs" /></a>