Skip to main content
Glama

@runhooks/mcp

Model Context Protocol (MCP) server for Runhooks — reliable HTTP scheduling infrastructure. It lets AI agents (Claude Desktop, Cursor, and any MCP client) schedule and manage cron jobs and webhooks directly.

The server runs locally on your machine: your MCP client spawns it with npx and it talks to the Runhooks REST API over HTTPS. There is no hosted service — just this package.

Install

Add it to your MCP client config. For Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "runhooks": {
      "command": "npx",
      "args": ["-y", "@runhooks/mcp"],
      "env": { "RUNHOOKS_API_KEY": "rh_live_..." }
    }
  }
}

No API key yet? Leave env out and ask the agent to run the provision_account tool — it creates an instant account (no email) and returns an rh_live_... key. Save that key as RUNHOOKS_API_KEY and restart your client.

Related MCP server: silentwatch-mcp

Verify

Check the server starts and advertises its tools (replace the key, or omit env and use provision_account from inside your client):

RUNHOOKS_API_KEY=rh_live_... npx -y @runhooks/mcp

Environment variables

Variable

Description

Default

RUNHOOKS_API_KEY

Your API key (rh_live_...). Required for all tools except provision_account.

—

RUNHOOKS_API_URL

API origin.

https://api.runhooks.app

Tools

Tool

Description

provision_account

Create an anonymous account and get an API key (no email).

whoami

Show the current account.

rotate_key

Rotate the API key.

create_job

Create a scheduled job (cron or interval).

list_jobs

List jobs with filters and pagination.

get_job

Get one job by ID.

update_job

Update a job.

delete_job

Delete a job.

pause_job / resume_job

Pause or resume a job.

list_executions

List a job's run history.

replay_execution

Re-run a past execution.

get_usage

Show plan usage and limits.

list_alerts / create_alert / get_alert / update_alert / delete_alert

Manage failure alerts (email, webhook, Slack).

License

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server for scheduling and executing Claude Code CLI tasks via cron expressions, featuring a web dashboard and webhook support. It enables users to dynamically create custom MCP servers, manage recurring AI jobs, and track execution history with token and cost analytics.
    24
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    An MCP server that surfaces scheduled-job state and detects silent failures (exit 0 but no useful output) for cron, systemd timers, and OpenClaw schedulers, enabling AI agents to query job health and overdue status directly.
    6
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that enables AI agents to execute real-world actions through 10 specialized engines covering authenticated API calls, browser automation, visual QA, shell commands, file operations, job scraping, and parallel task execution.
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that lets AI agents manage cron jobs through natural language — adding, listing, pausing, removing, running, and viewing logs of scheduled jobs with plain-English schedule parsing, automatic log capture, missed-run detection, and failure alerts.
    MIT