limehouse-calendar for Openclaw

A sophisticated calendar integration skill providing AI agents with granular per-calendar permissions to manage events and calculate travel times.

madeleinenakada
v1.0.1
Mar 20, 2026
0
872
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install limehouse-calendar

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 limehouse-calendar 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 limehouse-calendar?

limehouse-calendar is a robust Openclaw Skills integration designed to give AI agents secure, scoped access to user calendars. It stands out by implementing a sophisticated permission model where users can control exactly which calendars an agent can see and whether it has the authority to read, create, update, or delete specific events.

Beyond basic CRUD operations, this skill enables agents to perform complex scheduling tasks, handle timezones intelligently using IANA standards, and manage invitees. It bridges the gap between raw data and actionable scheduling by allowing agents to request permission changes dynamically, ensuring a transparent and user-controlled automation experience.

limehouse-calendar Use Cases

  • Automating meeting scheduling and invitee management across multiple calendar providers.
  • Synchronizing personal and work schedules with strict privacy boundaries using granular permissions.
  • Calculating and injecting travel time buffers into a schedule based on real-time transit or driving data.
  • Managing complex recurring events and timezone conversions for distributed teams.
  • Discovering and requesting access to unconnected calendars to expand agent utility.

How limehouse-calendar Works

  1. The agent initiates a setup session to obtain a secure CAL_API_KEY via a user-authorized OAuth-style flow.
  2. Using the agent info endpoint, the skill identifies which calendars are permitted and what specific actions (read/write/delete) are allowed.
  3. The agent queries available events using ISO 8601 time ranges, handling timezone offsets or date-only strings as needed.
  4. For event creation or updates, the skill validates the agent's permissions for both the event itself and the invitee list.
  5. Advanced logic can be triggered to calculate travel time from home, work, or previous events using integrated mapping data.
  6. If additional access is required, the agent generates a confirmation URL for the user to approve expanded permissions safely.

limehouse-calendar Setup

To integrate this skill, you must define the CAL_API_KEY in your environment. If you do not have a key, follow the session-based authentication flow:

# 1. Create a setup session
curl -X POST https://cal.limehouse.io/api/v1/setup/sessions

# 2. Poll for the agent_token after the user authorizes via the setup_url
curl https://cal.limehouse.io/api/v1/setup/sessions/{token}/poll

# 3. Set the environment variable
export CAL_API_KEY="cal_your_received_token"

limehouse-calendar Data Schema & Taxonomy

The skill interacts with several core data objects to maintain organization and security:

Object Key Fields Description
Agent Metadata id, permitted_calendars, connected_calendars_without_access Tracks what the agent is allowed to see and do.
Calendar id, name, timezone, color Represents a specific calendar container (e.g., Google or Outlook).
Event summary, start_time, end_time, recurrence_rule, invitees The primary data unit for scheduling.
Travel Object duration_seconds, distance_text, mode, origin Metadata generated when calculating buffers between events.

limehouse-calendar Advanced Features

  • Granular Permission Scoping: Specifically request can_create_invitees or can_update_invitees without full calendar write access.
  • Intelligent Travel Buffers: Automatically creates 'Travel Time' events using walking, driving, biking, or transit modes via Google Maps integration.
  • Dynamic Permission Requests: Allows agents to programmatically request access to new calendars by generating user-approval links.
  • Timezone Resilience: Support for IANA timezone strings ensures DST is handled automatically without manual offset calculations.
  • Conflict Handling: Built-in 409 Conflict logic manages overlapping permission requests to prevent user fatigue.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*