Advertise
MCP.so
Sign In
H

Hotkeyless Ahk MCP Server

@tim0-12432

Repository

Basic information

Category

Other

Transports

stdio

Author

tim0-12432

Submitted by

Timo

About Hotkeyless Ahk MCP Server

MCP server for Hotkeyless AHK HTTP API. It lets your agent control your whole computer through hotkeys.

#ahk#hotkeyless-ahk#hotkeys#auto-hotkey

Hotkeyless Ahk MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Hotkeyless Ahk MCP Server tools

4

Fetch available Hotkeyless commands from /list.

Trigger one Hotkeyless command by exact name using /trigger. Enforces blacklist and verifies command exists.

Send keystrokes through optional /send_keys endpoint. Returns clear error when endpoint is unsupported.

Move mouse cursor via optional /mouse_move endpoint. Returns clear error when endpoint is unsupported.

Overview

What is Hotkeyless Ahk Mcp?

Hotkeyless Ahk Mcp is a TypeScript MCP server that wraps the Hotkeyless AHK HTTP API, enabling AI agents to invoke AutoHotkey commands without needing keyboard shortcuts. It includes reusable skill documents for OpenCode, Claude Code, and GitHub Copilot, designed for desktop automation tasks.

How to use Hotkeyless Ahk Mcp?

Install and run via npx -y @tim0_12432/hotkeyless-ahk-mcp-server or build from source with bun install && bun run build. Configure the server in opencode.json, .mcp.json, or mcp-config.json with environment variables like BLACKLIST, BASE_URL, and TIMEOUT_MS. For skill documents, copy skill folders into the appropriate .opencode/skills, .claude/skills, or .github/copilot/skills directories.

Key features of Hotkeyless Ahk Mcp

  • Wraps the Hotkeyless AHK HTTP API as an MCP server
  • Configurable blacklist, timeout, cache, and server address
  • Supports OpenCode, Claude Code, and GitHub Copilot
  • Includes ready-to-use skill documents for agent runtimes
  • Can be run via npx or built from source

Use cases of Hotkeyless Ahk Mcp

  • Automate Windows desktop tasks via AI agent prompts
  • Execute AHK scripts without manual keyboard shortcuts
  • Integrate AHK commands into Claude Code or GitHub Copilot workflows
  • Build agent-driven UI automation and file management routines

Frequently asked questions

1

What runtime dependencies does Hotkeyless Ahk Mcp require?

It requires Node.js (to run npx or the built server) and a running instance of Hotkeyless AHK (listening on `http://localhost:42800` by default).

2

How can I restrict which commands the server may invoke?

Set the `BLACKLIST` environment variable to a comma‑separated list of commands to block, for example `"shutdown,restart,kill"`.

3

Does the server cache the list of available commands?

Yes, by default the command list is cached for 5000 ms. The cache time can be changed via the `CACHE_TTL_MS` environment variable.

4

What transport protocol does Hotkeyless Ahk Mcp use?

The MCP server runs as a local process using the standard input/output transport (stdio) for communicating with the MCP client.

5

Where does the server store or access user data?

The server does not store data itself; it only forwards commands to the Hotkeyless AHK HTTP API running on the local machine. All command execution happens on the user's system.

Comments

More Other MCP servers

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Advertise