Back to Browse
About
MCP server for Hotkeyless AHK HTTP API.
Security Report
10.0
Low Risk10.0Low RiskValid MCP server (4 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
13 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
The base URL of the Hotkeyless AHK HTTP server.
Environment variable: BASE_URL
The timeout in milliseconds for requests to the server.
Environment variable: TIMEOUT_MS
A comma-separated list of blacklisted commands.
Environment variable: BLACKLIST
The time-to-live in milliseconds for cached responses.
Environment variable: CACHE_TTL_MS
The default endpoint path for listing commands.
Environment variable: ENDPOINT_LIST
The default endpoint path for triggering commands.
Environment variable: ENDPOINT_TRIGGER
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-tim0-12432-hotkeylessahk-mcp-skill": {
"env": {
"BASE_URL": "your-base-url-here",
"BLACKLIST": "your-blacklist-here",
"TIMEOUT_MS": "your-timeout-ms-here",
"CACHE_TTL_MS": "your-cache-ttl-ms-here",
"ENDPOINT_LIST": "your-endpoint-list-here",
"ENDPOINT_TRIGGER": "your-endpoint-trigger-here"
},
"args": [
"-y",
"@tim0_12432/hotkeyless-ahk-mcp-server"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
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 examples
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 /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 | 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/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
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
80.0K
Stars
4
Installs
5.3
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
137
Stars
519
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
72
Installs
10.0
Security
4.6
Local