Keyboard Shortcuts MCP Server
This MCP server provides intelligent keyboard shortcut lookup using natural language queries powered by Claude Opus.
Key Capabilities:
Natural Language Querying: Search for keyboard shortcuts using conversational queries that Claude Opus intelligently matches against relevant shortcut data
Multi-Platform Support: Provides shortcuts for Ubuntu, macOS, and Windows across different operating systems
Desktop Environment Specificity: Includes shortcuts for desktop environments like GNOME and KDE
Application Coverage: Supports desktop apps (Firefox, VS Code), CLI tools (tmux, vim), and general system functions
Fast Performance: All shortcut data is loaded in-memory for quick filtering and retrieval
Claude Integration: Designed as an MCP server for Claude Desktop and Claude's Computer Use tool to enable automated computer interactions
Provides keyboard shortcuts for Firefox browser functionality including tab management, navigation, and browser-specific features
Provides keyboard shortcuts for GNOME desktop environment including window management, system functions, and desktop-specific operations
Provides keyboard shortcuts for KDE desktop environment operations and functionality
Provides keyboard shortcuts for macOS system operations, window management, and native applications
Provides keyboard shortcuts for tmux terminal multiplexer including pane management, window operations, and session control
Provides keyboard shortcuts for Ubuntu Linux system operations, applications, and desktop environment interactions
Provides keyboard shortcuts for Vim text editor including navigation, editing commands, and modal operations
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Keyboard Shortcuts MCP Server how do I switch between tabs in Firefox on Ubuntu?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 buildConfiguration
Set your Anthropic API key as an environment variable:
export ANTHROPIC_API_KEY="your-api-key-here"Usage
Running Standalone
pnpm startIntegrating 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 shortcutsdesktop(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 startArchitecture
Data Loader (
src/data-loader.ts): Loads all JSON files at startup into memoryOpus Client (
src/opus-client.ts): Wraps Anthropic SDK for intelligent queriesMCP Server (
src/index.ts): Exposesget_shortcutstool 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 toolget_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
Scored across 1 tool
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.
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.
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.
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
Related MCP Connectors
MCP connector that lets ChatGPT list, search, and run your Apple Shortcuts via a local Mac agent
Search 16,000+ API operations and 95 built tools by need, then call any of them by name
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Video how-to search for AI agents: 2,000+ video skills, tutorials and FFmpeg recipes. No key.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables 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 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables 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 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables LLMs to list, open, and run shortcuts from the macOS Shortcuts app, including dynamically generated tools for each available shortcut. Supports passing text or file input to shortcuts and returning their output.40 npmMIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables 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 npmMIT