← Back to Skills Marketplace
Email To Calendar
by
tonimelisma
· GitHub ↗
· v1.13.1
6283
Downloads
5
Stars
31
Active Installs
15
Versions
Install in OpenClaw
/install email-to-calendar
Description
Extract calendar events and action points from forwarded emails, store them for review, and create calendar events with duplicate detection. Use when the user forwards an email containing meeting invites, events, deadlines, or action items, and wants to extract structured items for calendar creation. Also use when the user asks to review previously extracted items or create calendar events from them.
Usage Guidance
Install only if you are comfortable granting the skill access to read email bodies, modify inbox state, and create/update calendar events. Prefer forwarded-email mode over direct inbox scanning, disable mark-read/archive until tested, review attendee and deadline-notification settings, and treat the shell=True validation path as a bug that should be fixed before using it in a sensitive environment.
Capability Analysis
Type: OpenClaw Skill
Name: email-to-calendar
Version: 1.13.1
The skill is designed with security in mind, explicitly forbidding direct CLI calls and enforcing the use of wrapper scripts. The `CHANGELOG.md` indicates a history of fixing shell injection vulnerabilities, and the current implementation uses safe argument passing via bash arrays and Python's `subprocess.run` with lists. File system access is confined to expected skill memory and configuration paths. Prompt injection surfaces in `SKILL.md` and `BOOT.md` are used defensively to constrain agent behavior and enforce safe practices, rather than to manipulate it maliciously. Email sending is for legitimate user notifications, not exfiltration.
Capability Assessment
Purpose & Capability
The core purpose fits the artifacts: read emails, extract events, and create or update calendar entries. However, the package also includes email label mutation, calendar deletion/undo behavior, attendee notifications, and outbound email sending while the declared capabilities list only read_email, create_calendar_event, and update_calendar_event.
Instruction Scope
The skill explicitly says to ask before creating calendar events, which is a meaningful control. At the same time, direct mode scans all unread emails, setup recommends accepting defaults, and processed emails/calendar replies are marked read and archived automatically based on config defaults.
Install Mechanism
No hidden installer, package manager action, obfuscation, or destructive install step was found. First-activation instructions do ask the agent to add recurring HEARTBEAT.md sections, which creates ongoing behavior after setup.
Credentials
Email and calendar access are proportionate to the stated function, but direct inbox monitoring, body search, attendee invite updates, and automatic mailbox disposition are high-impact and broader than a narrow forwarded-email workflow.
Persistence & Privilege
The skill persistently stores email IDs, subjects, event titles, pending invite data, changelog/undo data, and activity logs under ~/.openclaw/workspace/memory and configuration under ~/.config. This is disclosed, but retention and permission hardening are limited, and one validation path uses shell=True with interpolated values.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install email-to-calendar - After installation, invoke the skill by name or use
/email-to-calendar - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.13.1
- Improved reliability of email and calendar event processing scripts.
- Updated documentation for wrapper script usage and critical workflow rules.
- Minor clarifications and formatting updates in SKILL.md.
- Internal maintenance: scripts and configuration references refreshed for better consistency.
v1.13.0
email-to-calendar 1.13.0
- Added add_pending.sh script to record pending events for follow-up reminders.
- Updated SKILL.md with new workflow instructions for recording pending invites using add_pending.sh.
- Improvements and updates across scripts for handling pending events and invite reminders.
- Internal refactoring in duplicate checking, event extraction, and pending operations logic.
- Updated tests and documentation accordingly.
v1.12.2
email-to-calendar 1.12.2
- Updated version in SKILL.md to 1.12.2 (no operational or feature changes documented)
- package.json and SKILL.md version synchronizations only; behavior and rules unchanged
v1.12.1
**email-to-calendar v1.12.1**
- Added strict rule: never call `gog` directly—always use wrapper scripts (e.g., `create_event.sh`) to ensure event tracking and prevent duplicates.
- Now ignores calendar notification emails from addresses like `[email protected]`—these are not new events and are automatically archived via `process_calendar_replies.sh`.
- Updated rule ordering and language for greater clarity and emphasis in setup and event processing instructions.
- Documentation refined to clearly distinguish between allowed (`scripts/`) and forbidden (`gog` direct) operations.
- Minor updates to setup and workflow documentation for improved onboarding and reliability.
v1.12.0
- Added automatic email disposition handling after event creation via the new `disposition_email.sh` script.
- Integrated processing of email calendar replies and their disposition.
- Added disposition utilities and new test coverage for disposition operations.
- Updated documentation (SKILL.md, SETUP.md) to clarify that email disposition is now automatic and manual steps are no longer needed.
v1.11.0
**Provider abstraction and script-based email/calendar operations (breaking change):**
- All email and calendar actions must now use wrapper scripts in `scripts/`, not direct `gog` CLI or other provider commands.
- New scripts added for email and calendar operations: `email_read.sh`, `email_search.sh`, `email_send.sh`, `email_modify.sh`, `calendar_search.sh`, `calendar_delete.sh`.
- Core utilities refactored: email and calendar logic moved to `utils/calendar_ops.py` and `utils/email_ops.py`.
- `SKILL.md`, documentation, and workflow updated to require use of these scripts for all actions, ensuring tracking and extensibility.
- Lays groundwork for multi-provider support beyond Gmail/Google Calendar in future releases.
v1.10.0
**Summary: Adds deadline detection, action-required reminders, and URL extraction to the event workflow.**
- Detects RSVP/registration/ticket deadlines in emails and extracts related action items.
- Extracts all relevant URLs from emails and includes them at the top of event descriptions.
- Creates separate reminder calendar events for action-required deadlines (e.g., RSVP by date).
- Sends email notifications for items needing user action before an event.
- Documentation and workflow updated to reflect new deadline detection, reminder, and notification features.
- Adds CONTRIBUTING.md for improved project guidance and contributions.
v1.9.1
- Bumped version to 1.9.1.
- Updated SKILL.md to maintain documentation and reflect minor changes.
- No functional or behavioral changes in code; this is a documentation and version update only.
v1.9.0
**Changelog for email-to-calendar v1.9.0**
- Major internal refactor: scripts reorganized and new utils directory introduced for modular code.
- Comprehensive test suite added under scripts/tests/ with extensive coverage of activity, changelog, event tracking, pending invites, and undo logic.
- Documentation improvements: workflow and usage sections in SKILL.md streamlined and linked to SETUP.md; reference command list in references/gog-commands.md.
- New utility modules: event operations (event_tracking.py), common logic, JSON store helpers, and invite/undo management.
- All core shell scripts updated for improved modularity and maintainability.
- Enhanced pre-processing checks and activity logging for greater robustness.
v1.7.0
**Improved date parsing and workflow flexibility.**
- Added `scripts/utils/date_parser.py` for enhanced date parsing from email content.
- Updated scripts and documentation to improve event extraction accuracy.
- Clarified tool flexibility in SKILL.md: agents may use alternative email/calendar tools, not just the `gog` CLI.
- General stability and reliability improvements across event creation and duplicate detection workflows.
v1.6.0
email-to-calendar v1.6.0
- New: Added undo support for event creation; you can now undo event actions.
- New: Silent activity logging introduced for all email and event actions.
- Enhanced: Smart onboarding flow with auto-detected, suggested defaults for initial setup; fewer required questions.
- Enhanced: Day-of-week now always shown when presenting events for user verification.
- Improved: Email processing is now more robust—no longer skips forwarded emails by date header.
- Added scripts: activity_log.sh, changelog.sh, and undo.sh for logging, change review, and undo capabilities.
v1.5.0
**New: Pending Invite Management**
- Added scripts to list and update event invite status (pending invites).
- Heartbeat/reminder support for pending calendar invites.
- New `BOOT.md` and documentation updates for invite workflow.
- Updated existing scripts and config to support invite tracking and reminders.
v1.4.0
email-to-calendar 1.4.0
- Added a CHANGELOG.md file for improved version tracking.
- Removed the deprecated scripts/extract_events.py to streamline the codebase.
- Updated SKILL.md, package.json, and scripts/create_event.sh for compatibility and consistency with the new version.
- General cleanup and maintenance to support better tracking and event processing.
v1.3.0
Add event tracking system for efficient updates/deletions. Events are now tracked in events.json with helper scripts for lookup, update, and delete operations.
v1.0.0
Initial release: Extract calendar events from forwarded emails with duplicate detection and configurable event creation
Metadata
Frequently Asked Questions
What is Email To Calendar?
Extract calendar events and action points from forwarded emails, store them for review, and create calendar events with duplicate detection. Use when the user forwards an email containing meeting invites, events, deadlines, or action items, and wants to extract structured items for calendar creation. Also use when the user asks to review previously extracted items or create calendar events from them. It is an AI Agent Skill for Claude Code / OpenClaw, with 6283 downloads so far.
How do I install Email To Calendar?
Run "/install email-to-calendar" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Email To Calendar free?
Yes, Email To Calendar is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Email To Calendar support?
Email To Calendar is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Email To Calendar?
It is built and maintained by tonimelisma (@tonimelisma); the current version is v1.13.1.
More Skills