English Français العربية

Runhooks

Registre officiel Productivité

Schedule and manage recurring and one-off HTTP jobs on Runhooks from your AI agent.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @runhooks/mcp
Claude Code 
claude mcp add runhooks -e 'RUNHOOKS_API_KEY=<your runhooks_api_key>' -e 'RUNHOOKS_API_URL=<RUNHOOKS_API_URL>' -- npx -y @runhooks/mcp@0.1.10
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "runhooks": {
            "command": "npx",
            "args": [
                "-y",
                "@runhooks/mcp@0.1.10"
            ],
            "env": {
                "RUNHOOKS_API_KEY": "<your runhooks_api_key>",
                "RUNHOOKS_API_URL": "<RUNHOOKS_API_URL>"
            }
        }
    }
}

Variables d'environnement

  • RUNHOOKS_API_KEY secret Runhooks API key (rh_live_...). Required for all tools except provision_account; get one instantly with the provision_account tool, the dashboard, or the CLI.
  • RUNHOOKS_API_URL API origin override. Defaults to https://api.runhooks.app.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. @runhooks/mcp
  2. Install
  3. Verify
  4. Environment variables
  5. Tools
  6. Links
  7. License

@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 recurring and one-off HTTP jobs 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 once — it creates an instant account (no email), returns an rh_live_... key, and saves it locally to ~/.runhooks/mcp.json. The key is reused automatically from then on, so every other tool works immediately with no restart and no need to provision again. (Setting RUNHOOKS_API_KEY is still the most portable option across machines, and it always takes precedence over the saved key.)

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

VariableDescriptionDefault
RUNHOOKS_API_KEYYour API key (rh_live_...). Optional — provision_account saves a key locally if unset. Takes precedence over the saved key.—
RUNHOOKS_API_URLAPI origin.https://api.runhooks.app

Tools

ToolDescription
provision_accountCreate an anonymous account and get an API key (no email).
whoamiShow the current account.
rotate_keyRotate the API key.
create_jobCreate a scheduled job (cron or interval).
list_jobsList jobs with filters and pagination.
get_jobGet one job by ID.
update_jobUpdate a job.
delete_jobDelete a job.
pause_job / resume_jobPause or resume a job.
list_executionsList a job's run history.
replay_executionRe-run a past execution.
get_usageShow plan usage and limits.
list_alerts / create_alert / get_alert / update_alert / delete_alertManage failure alerts (email, webhook, Slack).

License

MIT

Questions fréquentes

Qu'est-ce que Runhooks ?

Schedule and manage recurring and one-off HTTP jobs on Runhooks from your AI agent.

Comment installer Runhooks ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add runhooks -e 'RUNHOOKS_API_KEY=<your runhooks_api_key>' -e 'RUNHOOKS_API_URL=<RUNHOOKS_API_URL>' -- npx -y @runhooks/mcp@0.1.10. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Runhooks ?

Oui. Il attend RUNHOOKS_API_KEY, à renseigner dans sa configuration.

Runhooks est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Runhooks ?

Il est publié par runhooks. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.