← Back to Skills Marketplace
Email To Calendar
by
Toni Melisma
· GitHub ↗
· v1.13.3
· MIT-0
6991
Downloads
5
Stars
0
Active Installs
17
Versions
Install in OpenClaw
/install email-to-calendar
Description
Turn emails into Google Calendar events. Scans your Gmail inbox (or only forwarded emails) to extract meetings, appointments, RSVPs, and deadlines, then crea...
Usage Guidance
Install only if you are comfortable giving the skill Gmail and Calendar authority. Before first use, review the setup defaults and consider disabling mark_read, archive, and auto_dispose_calendar_replies; inspect any proposed HEARTBEAT.md changes; and remember that local logs may contain email subjects, event titles, message IDs, and calendar metadata.
Capability Assessment
Purpose & Capability
Reading Gmail, creating/updating calendar events, optional reminder emails, attendee updates, and local event tracking are coherent with an email-to-calendar skill and are disclosed, but they are high-impact capabilities.
Instruction Scope
Event creation is repeatedly gated on user confirmation, but mailbox disposition, calendar-reply auto-processing, and cancellation-driven calendar deletion are not consistently gated by per-action confirmation.
Install Mechanism
No remote installer, obfuscated payload, or download-and-run behavior was found; the skill relies on bundled shell/Python wrappers and the local gog CLI. The artifact does not appear to provide a separate least-privilege permission manifest for shell, file, Gmail, and Calendar access.
Credentials
The bootstrap asks the agent to read and potentially modify a shared ~/.openclaw/workspace/HEARTBEAT.md file and to run calendar-reply processing during self-check, extending the skill into persistent recurring automation beyond a single user-requested extraction.
Persistence & Privilege
The skill stores event IDs, email IDs, subjects, event titles, pending invites, changelog, and activity sessions locally; this supports duplicate detection and undo, but retention controls, opt-out, and file-permission hardening are limited.
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.3
Add a concise README for the listing (value prop, features, install/setup, transparency). No functional changes.
v1.13.2
Spring-cleaning + publish hardening: rewrote stale reference docs to the current wrapper-script workflow, fixed SETUP/CONTRIBUTING inconsistencies, dropped vestigial package.json (added LICENSE), fixed the last shell=True call (safe list-form args), and rewrote the description with a transparency/disclosure section. No functional behavior change; 158 tests pass.
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?
Turn emails into Google Calendar events. Scans your Gmail inbox (or only forwarded emails) to extract meetings, appointments, RSVPs, and deadlines, then crea... It is an AI Agent Skill for Claude Code / OpenClaw, with 6991 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, licensed under MIT-0. 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 Toni Melisma (@tonimelisma); the current version is v1.13.3.
More Skills