Just Calendar CLI for Openclaw

A terminal-based interface for managing calendar data and habit tracking stored directly in Google Drive via the justcalendar.ai platform.

andredalmeida
v1.0.2
Mar 4, 2026
0
808
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install justcalendar

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install justcalendar using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Just Calendar CLI?

The Just Calendar CLI is a specialized Node.js tool that allows developers to interact with their Just Calendar data without leaving the command line. By integrating with Openclaw Skills, this tool provides a bridge between web-based calendar management and local terminal productivity. It uses backend-issued tokens to facilitate secure direct reads and writes to calendar data files stored within a dedicated Google Drive folder.

This skill is designed for users who value efficiency and want to automate their daily logging, habit tracking, or data analysis workflows. Whether you are managing simple checkboxes or complex scoring systems, the CLI ensures that your data remains synchronized across the Just Calendar ecosystem while providing the flexibility of a developer-centric interface.

Just Calendar CLI Use Cases

  • Automating daily habit tracking or productivity logging from terminal scripts.
  • Performing bulk data updates, such as backfilling missing dates or fixing historical records.
  • Managing multiple distinct calendars for health, work, or personal goals using Openclaw Skills.
  • Integrating calendar data management into CI/CD pipelines or automated developer dashboards.
  • Troubleshooting authentication and Google Drive permission states for the Just Calendar service.

How Just Calendar CLI Works

  1. The user installs the CLI package via npm to enable local execution.
  2. A secure agent token is generated through the Just Calendar web interface to authorize the CLI.
  3. The CLI is authenticated using the login command, which links the local environment to the justcalendar.ai backend.
  4. Users issue commands to list, create, or modify calendars, which are then reflected in the user's Google Drive storage.
  5. Data operations utilize a bulk-first logic to ensure high performance and minimize API overhead when processing multiple dates.

Just Calendar CLI Setup

Install the CLI globally using npm:

npm install -g justcalendar

Authenticate the CLI by generating a token at https://justcalendar.ai and running:

justcalendar login --token <YOUR_TOKEN> --url https://justcalendar.ai

Verify that the connection is active for use with Openclaw Skills:

justcalendar status

Just Calendar CLI Data Schema & Taxonomy

The skill manages data across local configuration files and remote Google Drive storage as follows:

Location File/Object Purpose
Google Drive JustCalendar.ai/ Main directory for all calendar JSON data.
Google Drive <account-id>_<calendar-id>.json Specific data points for an individual calendar.
Local ~/.justcalendar-cli/config.json Stores local session tokens and backend URLs.
Data YYYY-MM-DD The strict ISO format required for all date-based operations.

Just Calendar CLI Advanced Features

  • Bulk Data Operations: Execute set, get, or delete commands for multiple dates in a single shell command to maximize efficiency.
  • Multi-Type Support: Manage different data structures including signal-3 (colors), scores (-1 to 10), checks (boolean), and notes (text).
  • Drive-Backed Security: All data is stored in the user's personal Google Drive, ensuring full ownership and privacy within Openclaw Skills.
  • Flexible Selection: Interact with calendars using either their friendly display names or unique internal IDs.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*