Skip to main content
Glama
Keyboard Shortcuts MCP Server

Keyboard Shortcuts MCP Server

by jenova-marie

Keyboard Shortcuts MCP Server

A Model Context Protocol (MCP) server that provides keyboard shortcuts for various operating systems, desktop environments, and applications. Uses Claude Opus for intelligent natural language querying of shortcuts.

Primary Use Case: Designed to support Claude's Computer Use tool by providing accurate, context-aware keyboard shortcuts for automated computer interactions.

Features

  • šŸ” Intelligent Search: Uses Claude Opus to understand natural language queries

  • šŸ–„ļø Multi-Platform: Support for Ubuntu (GNOME desktop), with architecture for macOS/Windows

  • šŸ“± App-Specific: Desktop apps (Firefox, VS Code), CLI tools (tmux, vim), and system shortcuts

  • šŸš€ Fast: All shortcut data loaded in-memory for quick filtering

Related MCP server: Siri Shortcuts MCP Server

Installation

# Install dependencies
pnpm install

# Build the server
pnpm build

Configuration

Set your Anthropic API key as an environment variable:

export ANTHROPIC_API_KEY="your-api-key-here"

Usage

Running Standalone

pnpm start

Integrating with Claude Desktop

Add to your Claude Desktop MCP configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "keyboard-shortcuts": {
      "command": "node",
      "args": ["/path/to/keyboard-shortcuts-mcp/dist/index.js"],
      "env": {
        "ANTHROPIC_API_KEY": "your-api-key-here"
      }
    }
  }
}

Tool: get_shortcuts

Query keyboard shortcuts using natural language.

Parameters

  • os (required): Operating system - "ubuntu", "macos", or "windows"

  • query (required): Natural language question about shortcuts

  • desktop (optional): Desktop environment - "gnome", "kde", etc.

  • application (optional): Specific application - "firefox", "tmux", etc.

Examples

// Query tmux shortcuts (no desktop needed for CLI tools)
{
  "os": "ubuntu",
  "application": "tmux",
  "query": "how do I split a pane vertically?"
}

// Query Firefox shortcuts on GNOME
{
  "os": "ubuntu",
  "desktop": "gnome",
  "application": "firefox",
  "query": "how to open a new private window"
}

// Query GNOME window management
{
  "os": "ubuntu",
  "desktop": "gnome",
  "query": "tile window to left half of screen"
}

Data Structure

Shortcuts are organized as:

data/
└── ubuntu/
    ā”œā”€ā”€ desktops/
    │   └── gnome/
    │       ā”œā”€ā”€ window-management.json
    │       ā”œā”€ā”€ system-functions.json
    │       └── ...
    ā”œā”€ā”€ apps/
    │   ā”œā”€ā”€ browser/
    │   │   ā”œā”€ā”€ firefox.json
    │   │   └── chrome.json
    │   ā”œā”€ā”€ editor/
    │   │   ā”œā”€ā”€ vscode.json
    │   │   └── vim.json
    │   └── ...
    └── tools/
        ā”œā”€ā”€ tmux.json
        ā”œā”€ā”€ vim.json
        └── ...

Each JSON file contains:

{
  "os": "ubuntu",
  "desktop": "gnome" | null,
  "application": "firefox" | null,
  "file": "firefox",
  "categories": [
    {
      "name": "Tab Management",
      "shortcuts": [
        {
          "keys": "Ctrl + T",
          "description": "New tab"
        }
      ]
    }
  ]
}

Development

# Watch mode (auto-reload on changes)
pnpm dev

# Build TypeScript
pnpm build

# Run built server
pnpm start

Architecture

  1. Data Loader (src/data-loader.ts): Loads all JSON files at startup into memory

  2. Opus Client (src/opus-client.ts): Wraps Anthropic SDK for intelligent queries

  3. MCP Server (src/index.ts): Exposes get_shortcuts tool via MCP protocol

The server filters shortcuts by OS/desktop/app, then passes relevant data + user query to Claude Opus for intelligent matching.

License

MIT

Available Tools

1 tool
get_shortcutsB

Query keyboard shortcuts for a specific OS, desktop environment, and/or application. Uses Claude Opus to intelligently search and return relevant shortcuts based on natural language queries.

Inputs: os (required), query (required), desktop, application.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or confusion between tools. The single tool 'get_shortcuts' has a clear, distinct purpose that cannot be mistaken for any other functionality within this server.

    Naming Consistency5/5

    The single tool name 'get_shortcuts' follows a clear verb_noun pattern (get + shortcuts). With only one tool, consistency is inherently perfect as there are no other names to compare or conflict with.

    Tool Count2/5

    A single tool is generally too few for a server's purpose, especially one focused on keyboard shortcuts which could benefit from operations like listing available OS/applications, updating shortcuts, or searching by category. The scope feels thin and incomplete with just one query tool.

    Completeness2/5

    The server is severely incomplete for a keyboard shortcuts domain. While 'get_shortcuts' provides query functionality, there are obvious gaps: no ability to list supported systems/applications, create custom shortcuts, update existing ones, or manage shortcut sets. This will limit agent workflows significantly.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables LLMs to list, open, and run shortcuts available in the macOS Shortcuts app, including automatically generated per-shortcut tools. Supports optional text or file-path input and returns shortcut output when available.
      40 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables LLMs to list, open, and run shortcuts from the macOS Shortcuts app, including passing optional text or file input and dynamically exposing each available shortcut as its own tool.
      40 npm
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables LLMs to list, open, and run shortcuts from the macOS Shortcuts app, including dynamically generated tools for every available shortcut. Shortcuts can be invoked with optional text or file input, and their output is returned to the model.
      40 npm
      MIT