Calendar Management Skill for Openclaw

A secure, developer-friendly calendar management skill designed to safely list, search, and manage Google Calendar and Outlook events.

porteden
v1.0.4
May 25, 2026
3
1.9k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install calendar-skill

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 calendar-skill 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 Calendar Management Skill?

The Calendar Management skill is a powerful extension designed for managing calendar events securely across Google Calendar, Microsoft Outlook, and Microsoft Exchange. Built on top of the porteden command-line tool, it offers an advanced, secure alternative to legacy tools. This skill integrates seamlessly within the broader ecosystem of Openclaw Skills, enabling AI agents and automated scripts to securely interact with active calendar profiles, fetch agendas, and organize meetings.

Security is a fundamental design principle for this calendar-skill. It stores credentials safely in the system keyring and enforces a strict confirmation policy for any state-altering operations such as creating, updating, or deleting events. To ensure efficient communication between AI models and APIs, it features optimized JSON outputs that prevent token bloat, ensuring high-speed processing while keeping sensitive metadata safe.

Calendar Management Skill Use Cases

  • Automating daily agenda retrieval and generating high-level summaries using Openclaw Skills.
  • Searching through scheduled meetings and quickly identifying conflict windows using flexible query flags.
  • Verifying meeting details, organizer info, and attendee lists directly from secure CLI outputs.
  • Managing tentative responses, accepting invites, and declining events without leaving your developer environment.
  • Safely scheduling new syncs, adding workspace invitees, and syncing time zones dynamically.

How Calendar Management Skill Works

  1. Secure Session Initiation: The porteden CLI initializes and authenticates the user, checking for environment keys like PE_API_KEY or utilizing local system keyring credentials.
  2. Targeted Querying: The AI agent or user runs structured search or list commands, utilizing powerful filters like --today, --week, or --from/--to ranges.
  3. Optimized AI Parsing: Using the -jc flag, the skill outputs a minimized, token-friendly JSON structure that lists core event metrics, making execution via Openclaw Skills highly efficient.
  4. Mutation Safety Loop: If a modifying action (create, update, delete) is triggered, the skill halts for explicit user approval, outputting the targeted profile, calendar ID, and details to prevent accidental overrides.
  5. State Updates and Notifications: Upon confirmation, the event is updated on the provider's server, with optional automated attendee email invites or cancellations.

Calendar Management Skill Setup

Installation

Install the porteden CLI using your preferred package manager:

# Via Homebrew (Recommended)
brew install porteden/tap/porteden

# Via Go
go install github.com/porteden/cli/cmd/porteden@latest

Authentication and Configuration

Set up your workspace with the following steps:

# Standard browser login (recommended, stores tokens securely in keyring)
porteden auth login

# Token-based direct login
porteden auth login --token <your-secure-token>

# Check authentication status
porteden auth status

# Terminate and clear your session credentials
porteden auth logout

Alternatively, you can export your API keys directly into your environment setup:

export PE_API_KEY="your_api_key_here"
export PE_PROFILE="work"

Calendar Management Skill Data Schema & Taxonomy

Event Status Values

This skill maps all incoming event statuses to standard states:

Status Value Description
confirmed The event is accepted and scheduled
tentative The user is tentative or maybe attending
needsAction The event requires user confirmation or a response
cancelled The event has been canceled or deleted

Time & Metadata Taxonomy

All dates and times are processed strictly under standard formats for reliable Openclaw Skills execution:

  • RFC3339 UTC Format: All timestamp entries conform to standardized representations, e.g., 2026-02-01T10:00:00Z.
  • All-Day Events: Supports midnight-to-midnight spans using the --all-day configuration flag.
  • Payload Fields: JSON data returns startUtc, endUtc, and durationMinutes to make parsing straightforward.
  • Pagination Metadata: Features structural elements such as meta.hasMore and meta.totalCount for custom iteration logic.

Calendar Management Skill Advanced Features

  • Token-Optimized Payload Shorthand: The -jc (--json --compact) output cuts out heavy API metadata, limiting attendee noise and description size to keep LLM context windows lean.
  • Dynamic Contact Mapping: Execute partial matching queries such as --name "Smith" or specify domains like "@acme.com" to pull meetings linked to specific entities.
  • Strong Security Isolation: Use the PE_PROFILE environment variable to sandbox tasks, preventing work and personal scheduling workflows from cross-contaminating.
  • Granular Mutation Controls: Easily manipulate attendee invites using --add-attendees and regulate automated dispatching with the --notify and --no-notify flags.
  • Fail-Safe Prompting: Safeguards schedules against automated mistakes by formatting descriptive console printouts before committing destructive actions.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins porteden
Github Stars: 0
forks: 0

Featured*