HotkeylessAHK Mcp Skill

io.github.tim0-12432Published by GitHub account tim0-12432v1.0.8Updated Oct 24, 2026

MCP server for Hotkeyless AHK HTTP API.

VerifiedSTDIODesktop onlyProductivity & Workflow Developer Tools

Server details

Identifier: io.github.tim0-12432/HotkeylessAHK-mcp-skill
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account tim0-12432 for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.tim0-12432%2FHotkeylessAHK-mcp-skill.svg)](https://sourceweft.com/mcp/io.github.tim0-12432%2FHotkeylessAHK-mcp-skill?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

A local MCP server that wraps the Hotkeyless AHK HTTP API, letting an assistant list and trigger AutoHotkey commands on a Windows desktop.

What you can do: List available Hotkeyless AHK commands with their notes from the command-list endpoint, cached for a configurable time-to-live (GET /list).
When to use it: Use it when you want an assistant to drive a Windows desktop through an existing Hotkeyless AHK setup, for example to trigger AutoHotkey actions by command name instead of pressing hotkeys.
Requirements: Runs as a local Node.js process via npx from the npm package, or built from source. Needs a reachable Hotkeyless AHK HTTP server, by default at set through BASE_URL. Optional environment variables: TIMEOUT_MS, BLACKLIST, CACHE_TTL_MS, ENDPOINT_LIST, ENDPOINT_TRIGGER. Desktop only; no authentication is declared.

Before you install

Triggering commands acts on the user's desktop and can run whatever AutoHotkey scripts are registered, so effects may be hard to undo. Use BLACKLIST to block dangerous commands such as shutdown, restart or kill. Requests go to the configured BASE_URL, which defaults to localhost; point it only at a trusted server.

Installation

In SourceWeft

Open HotkeylessAHK Mcp Skill in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

text

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

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

MCP server

Agent skills

Quick start

MCP server

Quick start

OpenCode

opencode.json:

json

{  ...  "mcp": {    ...    "hotkeyless-ahk": {      "type": "local",      "command": ["npx", "-y", "@tim0_12432/hotkeyless-ahk-mcp-server"],      "enabled": true,      "environment": {          "BLACKLIST": "shutdown,restart,kill"          ...      }    }  },  ...}

{  ...  "mcp": {    ...    "hotkeyless-ahk": {      "type": "local",      "command": ["npx", "-y", "@tim0_12432/hotkeyless-ahk-mcp-server"],      "enabled": true,      "environment": {          "BLACKLIST": "shutdown,restart,kill"          ...      }    }  },  ...}

ClaudeCode

.mcp.json:

json

{  "mcpServers": {    ...    "hotkeyless-ahk": {      "command": "npx",      "args": ["-y", "@tim0_12432/hotkeyless-ahk-mcp-server"],      "env": {        "BLACKLIST": "shutdown,restart,kill"        ...      }    }  }}

{  "mcpServers": {    ...    "hotkeyless-ahk": {      "command": "npx",      "args": ["-y", "@tim0_12432/hotkeyless-ahk-mcp-server"],      "env": {        "BLACKLIST": "shutdown,restart,kill"        ...      }    }  }}

Github Copilot

mcp-config.json:

json

{  ...  "mcpServers": {    ...    "hotkeyless-ahk": {      "type": "local",      "command": "npx",      "args": ["-y", "@tim0_12432/hotkeyless-ahk-mcp-server"],      "env": {        "BLACKLIST": "shutdown,restart,kill"          ...      },      "tools": ["*"]    }  },  ...}

{  ...  "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

npm should also work without problems!

2. Setup your harness

OpenCode

opencode.json:

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": {    ...    "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:

json

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

{  "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:

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

{  ...  "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

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

.opencode/skills for project specific skill setup
%USERPROFILE%/.config/opencode/skills for 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/skills for project specific skill setup
%USERPROFILE%/.config/claude-code/skills for 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/skills for project specific skill setup
%USERPROFILE%/.config/claude-code/skills for 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

MIT

Source: README.md at commit 97afad0

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.0.8LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts