# iCal Calendar Parser MCP > iCal Calendar Parser lets your AI client read and analyze local .ics calendar files. Instead of trying to access live accounts, you export your schedule from Google, Apple, or Outlook. This MCP reads that file and gives the AI a clean JSON timeline containing every event's title, time, location, and attendees. Use this to find free slots, count meetings for a month, or quickly search for specific dates without needing network access. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** ical, calendar, scheduling, file-parsing, time-management, data-extraction ## Description Your agent can’t just look at your calendar; it has to read the file you give it. That’s the problem iCal Calendar Parser solves. You export your schedule—whether from Google Calendar, Apple Calendar, or Outlook—as a standard .ics file. This MCP reads that exported data and turns every single meeting into structured JSON. The AI can then instantly analyze this timeline to answer questions like, “When is my first opening next week?” or “How many client calls did I have last quarter?” You get back clean, sortable data without ever exposing your live account details. Vinkius hosts this MCP so you can connect it once from any compatible agent and access structured scheduling data instantly. ## Tools ### parse_ical_calendar Reads a local .ics calendar file path (from Google, Apple, or Outlook) and outputs all events into structured JSON data. ## Prompt Examples **Prompt:** ``` Read my calendar export and tell me if I have any free time tomorrow afternoon. ``` **Response:** ``` Tomorrow afternoon you have a meeting from 2-3 PM and another from 4-5 PM. You're free from 3 PM to 4 PM. ``` **Prompt:** ``` How many meetings did I have this month? Group them by day of the week. ``` **Response:** ``` This month: Monday (8), Tuesday (6), Wednesday (5), Thursday (7), Friday (3). Total: 29 meetings. ``` **Prompt:** ``` Find all events that contain the word 'dentist' in my calendar. ``` **Response:** ``` Found 2 'dentist' events: June 15 at 10 AM and September 3 at 3 PM. ``` ## Capabilities ### Identify open slots The AI scans the timeline to calculate gaps between meetings, telling you exactly when you're free. ### Count events by criteria You can ask your agent to count how many meetings occurred in a specific month or group them by day of the week. ### Summarize event details The MCP extracts and organizes key data points, including titles, locations, and attendee lists for every entry. ### Find specific topics Search the entire calendar file for events containing keywords, like 'dentist' or a client name. ## Use Cases ### Finding a time slot with 3 people A PM needs to schedule a review. They ask their agent: 'Using my calendar export, find three open slots next week when both John and Sarah are free.' The agent uses `parse_ical_calendar` to analyze the data and suggests available times. ### Auditing meeting load An analyst wants to report on Q3 activity. They ask: 'How many client meetings did I have this quarter, grouped by month?' The agent uses `parse_ical_calendar` to count and categorize the events from the exported file. ### Checking for specific contacts A user needs to find every meeting mentioning a particular client. They ask: 'Show me all appointments that include the word 'dentist' in my calendar export.' The agent queries the structured JSON output directly. ### Generating weekly summaries Before leaving for vacation, an executive wants to know their workload. They ask: 'Generate a summary of all meetings and attendees for next week,' allowing the agent to pull details from the parsed calendar data. ## Benefits - Instant Conflict Resolution: By parsing the file, you can ask your agent to check for time conflicts across multiple days in one go. It's much faster than manually looking at dates and times. - Universal Compatibility: This MCP handles standard .ics exports from Google Calendar, Apple Calendar, and Outlook. You don't need a specific connector—just the file. - Privacy First: Because this process requires you to provide an absolute local file path, your personal schedule data never leaves your machine. It’s 100% air-gapped. - Structured Data Output: The tool converts messy calendar entries into clean JSON, letting your agent reliably count meetings or pull out specific attendee names without guessing the structure. - Efficiency for Reporting: Instead of manually compiling a list of all events for a month, you send the file and let the MCP summarize it instantly. ## How It Works The bottom line is you give it an export file, and it gives the AI perfectly organized data points for querying. 1. First, export your full calendar schedule from Google Calendar, Apple Calendar, or Outlook into a single .ics file. You must provide the absolute path to this local file. 2. Your AI client invokes the `parse_ical_calendar` tool, pointing it to that exported file location. The MCP runs the parser and extracts all event data offline. 3. The result is a clean, chronologically sorted JSON structure delivered back to your agent. You can then prompt your agent with complex questions about this structured timeline. ## Frequently Asked Questions **How do I export my Google Calendar?** Go to calendar.google.com > Settings > Import & Export > Export. It downloads a .zip containing .ics files for each calendar. **Can it detect scheduling conflicts?** Yes! Because events are sorted chronologically with start/end times, the AI can easily spot overlapping events and alert you. **Does it include recurring events?** Yes, the parser expands recurring events according to the iCal RRULE specification, so each individual occurrence appears as its own entry. **When I run `parse_ical_calendar`, is my personal calendar data sent over the internet?** No, your schedule never leaves your machine. This MCP processes files locally, keeping your private events entirely air-gapped and secure. **Does `parse_ical_calendar` work if my .ics file contains more than 200 events?** The parser is capped at processing the first 200 events. For larger exports, you'll need to break them into smaller files or run the tool in batches. **What happens if my calendar export file has minor formatting errors?** The parser handles common structural issues and attempts to extract valid data points. If an event is completely corrupted, it simply skips that entry and continues processing. **How does `parse_ical_calendar` handle different time zones from my calendar?** The resulting JSON includes detailed time zone information for every event's start and end times. This ensures your AI agent understands when those meetings actually take place. **What types of files can I pass to `parse_ical_calendar`?** You must provide an absolute file path pointing to a standard .ics calendar export. The tool does not read directly from live online services; you must download the file first.