MCP Marketplace
Sign inSign up
Back to Browse

HotkeylessAHK Mcp Skill MCP Server

by Tim0 12432
Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

MCP server for Hotkeyless AHK HTTP API.

About

MCP server for Hotkeyless AHK HTTP API.

Security Report

10.0
Low Risk10.0Low Risk

Valid 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.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

file_system

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

The base URL of the Hotkeyless AHK HTTP server.Optional

Environment variable: BASE_URL

The timeout in milliseconds for requests to the server.Optional

Environment variable: TIMEOUT_MS

A comma-separated list of blacklisted commands.Optional

Environment variable: BLACKLIST

The time-to-live in milliseconds for cached responses.Optional

Environment variable: CACHE_TTL_MS

The default endpoint path for listing commands.Optional

Environment variable: ENDPOINT_LIST

The default endpoint path for triggering commands.Optional

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 GitHub

From the project's GitHub 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

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

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 overrideWhat it doesDefault
BASE_URLAdress of the Hotkeyless AHK serverhttp://localhost:42800
TIMEOUT_MSTimeout milliseconds for each request4000
BLACKLISTA list of commands to avoid being called[]
CACHE_TTL_MSCache lifetime for command list in milliseconds5000
ENDPOINT_LISTEndpoint address of the command list/list
ENDPOINT_TRIGGEREndpoint 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

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

80.0K
Stars
14
Installs
6.5
Security
No ratings yet
Local

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

80.0K
Stars
15
Installs
5.3
Security
No ratings yet
Local

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

180
Stars
682
Installs
8.0
Security
4.8
Local

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

-
Stars
111
Installs
10.0
Security
4.7
Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

-
Stars
81
Installs
10.0
Security
5.0
Remote

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

168.6K
Stars
79
Installs
4.2
Security
5.0
Local