MCP Server - CliBook | AI Agent Integration for Scheduled Commands

What is MCP?

MCP (Model Context Protocol) is an open standard that allows AI agents to interact with external tools and services. CliBook's MCP server gives agents direct access to your scheduled commands — create, update, toggle, and monitor schedules without leaving your AI workflow.

Instead of manually opening CliBook to set up a cron job, just tell your AI agent: "Create a schedule that runs brew upgrade every Sunday at 9am" — and it handles the rest.

Quick Setup

Add CliBook's MCP server to your AI agent in seconds.

Go to Settings > MCP Server in CliBook and click "Install to Claude Code", or manually add to ~/.claude.json:

{
  "mcpServers": {
    "clibook-scheduler": {
      "type": "stdio",
      "command": "~/.local/bin/clibook-mcp",
      "args": []
    }
  }
}

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "clibook-scheduler": {
      "command": "~/.local/bin/clibook-mcp",
      "args": []
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "clibook-scheduler": {
      "command": "~/.local/bin/clibook-mcp",
      "args": []
    }
  }
}

Add to ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "clibook-scheduler": {
      "type": "stdio",
      "command": "~/.local/bin/clibook-mcp",
      "args": []
    }
  }
}

After adding the config, restart Copilot CLI or start a new session with copilot -p "list my schedules" to verify.

Add to .vscode/mcp.json in your project:

{
  "servers": {
    "clibook-scheduler": {
      "command": "~/.local/bin/clibook-mcp",
      "args": []
    }
  }
}

Available Tools

7 tools your AI agent can use to fully manage scheduled commands.

list_schedules

List all scheduled commands with current status, cron expression, and execution metadata.

No parameters required.

create_schedule

Create a new scheduled command.

name* command* cronExpression* workingDirectory timeoutSeconds envVars retryCount retryIntervalSeconds notifyOnSuccess notifyOnFailure

* = required. Defaults: workingDirectory (~), timeoutSeconds (300), retryCount (0), retryIntervalSeconds (60), notifyOnSuccess (false), notifyOnFailure (true).

update_schedule

Update an existing schedule. Only provided fields are changed.

id* name command cronExpression + all optional fields

delete_schedule

Delete a schedule and all its execution history.

id*

toggle_schedule

Enable or disable a schedule.

id*

get_executions

Get execution history with stdout/stderr, exit codes, and timing.

scheduleId* limit

Default limit: 20.

run_now

Execute a schedule immediately and return the result.

id*

Example Prompts

Just tell your AI agent what you need in plain English.

"Create a schedule that runs brew update && brew upgrade every Sunday at 9am"

"List all my scheduled commands"

"Disable the database backup schedule"

"Show me the last 5 executions of my health check schedule"

"Create a schedule to run git pull in ~/projects/myapp every hour"

"Set up a daily Claude Code task at 10am to review code in ~/projects/myapp"

How It Works

1

Bundled Binary

CliBook bundles a standalone MCP binary (clibook-mcp)

2

Stdio Transport

AI agents launch it as a subprocess and communicate via stdio

3

JSON-RPC 2.0

Communication uses the standard Model Context Protocol over JSON-RPC

4

Local Database

Reads and writes directly to CliBook's local database

5

Instant Sync

Changes appear instantly in CliBook's Scheduler UI

6

Auto-Updates

The MCP binary auto-updates when CliBook is updated

Prerequisites

CliBook must be launched at least once to create the local database.
The MCP binary is installed at ~/.local/bin/clibook-mcp
Install via Settings > MCP Server, or it auto-syncs on app startup.

Ready to automate with AI?

Download CliBook and set up MCP in under a minute.

Download CliBook

MCP Server for AI Agents