markdown-to-gcal

Parse structured markdown files to create or update Google Calendar events via MCP.

1|Updated Dec 9, 2024
One-click install
npx skills add https://github.com/hadenlabs/tasks --skill markdown-to-gcal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: markdown-to-gcal
Source: https://github.com/hadenlabs/tasks/tree/main/.claude/skills/markdown-to-gcal
Command: npx skills add https://github.com/hadenlabs/tasks --skill markdown-to-gcal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converting structured markdown event files into Google Calendar events and keeping them in sync with idempotent updates via MCP.

Core Features & Use Cases

  • Convert a structured markdown file into a Google Calendar event using the MCP integration.
  • Parse event metadata (title, start, end, timezone, attendees, recurrence) and optional description and location.
  • Create or update events in Google Calendar by validating/using an event ID; automatically write new IDs back to the markdown.
  • Supports multiple date formats (simplified, ISO 8601, natural language, relative) and duration-based end if needed.

Quick Start

Provide a markdown file with a valid event section and metadata, then invoke the skill to create or update the calendar event via MCP.

Frequently Asked Questions about markdown-to-gcal

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create Google Calendar events from a markdown file?

To create Google Calendar events from a markdown file, the skill parses structured event metadata like title, start, end, timezone, and attendees, validating inputs and converting multiple date formats to ISO 8601 before syncing via MCP.

Can I sync markdown calendar events idempotently with Google Calendar?

Yes, idempotent syncing is supported by validating and using an optional event ID. When creating new events, the skill automatically writes the new IDs back to the markdown file to ensure subsequent updates target the correct calendar entry.

What date formats are supported when parsing markdown for calendar events?

The parsing mechanism supports multiple date formats including simplified, ISO 8601, natural language, and relative dates. It also handles duration-based end times to ensure accurate event scheduling in Google Calendar.

Does the markdown to Google Calendar sync support recurring events and locations?

Yes, the markdown parser supports recurrence rules and location fields alongside attendees and optional descriptions. These metadata fields are extracted and validated before creating or updating the Google Calendar event.

Do I need MCP to update Google Calendar from markdown?

Yes, MCP integration is required to create or update Google Calendar events from the parsed markdown file. The skill relies on MCP to handle the communication and idempotent syncing with the calendar service.