Skip to main content
Glama

One local MCP connection for KillerTools and the Killer app family: KillerPDF, KillerNotes, KillerScan, KillerShell, and Killendar.

KillerMCP detects installed apps, registers one MCP server with supported agent clients, and exposes useful tools through each app's own interface. The app repositories remain responsible for their CLI and service behavior. This repository owns the shared runtime, app adapters, installer, and integration checks.

Install

Download the signed KillerMCP installer, run setup, then open a new agent chat. Setup registers KillerMCP with Codex, Claude Code, Claude Desktop, Cursor, GitHub Copilot, Gemini CLI, and Windsurf when those clients are found.

Once connected, ask naturally:

  • killer domain search example.com

  • killer merge these PDFs

  • killerscan 192.168.8.0/24

The server supplies tool descriptions and instructions to help the client select the appropriate tool. Client behavior varies, so these phrases are guidance rather than guaranteed commands.

Related MCP server: Cupertino

Current status

KillerMCP has a shared stdio host. It runs the bundled server from the KillerTools site repository and adds app tools to the same connection. Current app adapters offer KillerPDF merging on the released 1.8 line, with preflight and accessibility reports when a build advertises those commands. KillerScan offers local network information and bounded scans. KillerShell file search, KillerNotes search, and Killendar agenda lookup appear when their CLI executables are available. Notes and calendar queries read the active database without changing it and currently cannot unlock encrypted files. The signed Windows installer packages the runtime, registers one MCP connection in Codex, Claude Code, Claude Desktop, Cursor, GitHub Copilot, Gemini CLI, and Windsurf when those clients are available, and adds a Windows Installed Apps uninstall entry. The exact signed installer passes isolated install, reinstall, seven client registrations, MCP discovery, representative calls, modified-file protection, uninstall, and clean Windows Sandbox testing.

The public app websites each have an /mcp page describing their tools and linking to the same KillerMCP setup. The single local connection does not require a separate MCP subdomain for each app.

See What KillerMCP can do for a human-readable guide to every KillerTools utility, the public app integrations, example requests, limits, and data handling.

Build from source

Build the KillerTools local MCP bundle first. Then run node scripts/build.mjs <absolute path to killermcp.mjs> in this repository. This stages the shared host, the KillerTools bundle, and app adapter files in dist/. The runtime looks for the app executables in their standard per-user and machine-wide install folders. It checks the KillerPDF, KillerScan, KillerNotes, and Killendar help output before listing their supported tools. For development builds or custom locations, set KILLERPDF_CLI, KILLERSCAN_CLI, KILLERNOTES_CLI, KILLENDAR_CLI, and KILLERSHELL_CLI to absolute executable paths. An invalid override leaves that app's tools unavailable instead of falling back to another copy.

On Windows x64 with Node 24.14.1, run node scripts/build-portable.mjs to add a Node executable and its license to dist/portable/. This portable package runs without a Node installation on the target machine. Run powershell -NoProfile -File scripts/build-installer.ps1 to embed it in an unsigned local test installer. Run powershell -NoProfile -File scripts/test-installer.ps1 to verify isolated installation, reinstall, seven client registrations, preservation of unrelated client settings, MCP discovery, a tool call, and uninstall without changing current client profiles.

Run powershell -NoProfile -File release.ps1 to rebuild the KillerTools bundle, build and sign KillerMCP Setup with SimplySign, verify its timestamp and trust chain, repeat the exact installer tests, and write SHA256SUMS.txt. This command does not publish. Add -Publish only after main has been reviewed and pushed to create the version tag and GitHub release.

The integration smoke script checks discovery, representative calls, released-version compatibility, and app detection. The scan check targets only loopback; the Notes and Killendar integration checks do not read personal databases. Set KILLERMCP_SERVER and KILLERMCP_NODE to test a copied portable package.

Run node scripts/discovery-test.mjs to check standard install-folder detection and development overrides. KillerNotes 1.3.1, Killendar 1.1.4, and KillerShell 1.2.6 serve their commands from their installed executables with --cli after those app versions are installed.

Public installers are published through KillerMCP releases.

License

KillerMCP is licensed under the GNU General Public License Version 3.

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables centralized management and unified interface for multiple child MCP servers (filesystem, sqlite, etc.), allowing users to discover, launch, and execute tools across different MCP servers through a single gateway.
    -
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides MCP servers to interact with Apple's Mail, Notes, Reminders, and Calendar apps on macOS, enabling search, read, and write operations with configurable permissions and a single Full Disk Access grant.
    4
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI assistants to securely access local machine capabilities such as file operations, shell commands, Skills, and Pi Tools through a controlled MCP interface with token authorization and multiple tunnel options.
    19 npm
    1
    MIT
  • A
    license
    C
    quality
    B
    maintenance
    Local macOS MCP servers for Mail, Calendar, Reminders, Notes, Contacts, Messages, Shortcuts, Files, Maps, and system tools. The unified Apple Tools server and individual app servers run over stdio with native macOS permissions; this is an MIT-licensed community project, unaffiliated with Apple.
    184
    16
    MIT