ICS to JSON Converter

Turn a calendar file into structured event data for your scripts and apps. Upload or paste ICS, inspect the JSON here, then copy or download it for free.

No account needed
Free. No credits used. Processed on your device.

Calendar input

.ics → .json

or drop a calendar here

One .ics or .ical file, up to 2 MB.
Extract ZIP exports first.

Fictional exampleexample-calendar.ics2 event records · 1 repeating series · 1 all-day

Your file and draft stay in this tab while you browse this website. Refreshing or closing the tab clears them.

Example result

JSON preview

2 event records in one JSON array. Preview, copy and download use the same text.

One object per VEVENT. Repeats stay as rules.See the JSON field guide

Up to 2 MB and 5,000 event records. Selected event fields only; keep your original ICS as a backup.

How to convert ICS to JSON

  1. 1. Open your calendar data

    Choose an ICS export from Google Calendar, Outlook, Apple Calendar or another app. You can also paste the complete ICS source. Your file is read on your device.

  2. 2. Inspect the JSON preview

    Review the event count and any conversion notes. Check dates, time zones and recurrence fields. Use Pretty print for readable indentation or turn it off for compact JSON.

  3. 3. Copy or download

    Copy the complete array into your code, or download a UTF-8 JSON file. Both actions use the text shown in the preview and include every event record.

See an ICS to JSON example

The working example contains two fictional records. Studio review starts at 09:30 in America/New_York on November 16, 2026, repeats four times weekly, and excludes November 23. Open studio weekend covers November 21–22 as one all-day event.

This excerpt comes from the first object in the built-in example. Select Try example in the converter, then Paste ICS to inspect its source. The example’s full JSON includes every documented field and is ready to copy or download.

{
  "summary": "Studio review",
  "start": "2026-11-16T09:30:00",
  "timeZone": "America/New_York",
  "rrule": [
    "FREQ=WEEKLY;COUNT=4"
  ],
  "exdate": [
    {
      "value": "2026-11-23T09:30:00",
      "type": "date-time",
      "timeZone": "America/New_York",
      "range": null
    }
  ]
}

Notice that the excluded date keeps the same named time zone as the series. The weekend’s end is November 23 because ICS stores the first date after an all-day event.

JSON field guide

The converter returns one object per VEVENT, preserving source order and duplicate records. Every object has the keys below. Optional missing values are null, lists are [], and a missing title is "". This predictable shape lets a script read fields without guessing a spreadsheet column name.

Fields in each exported event object
JSON fieldTypeMeaning
uid, summarystring / nullOriginal event identifier and decoded title. A missing title is an empty string; a missing UID is null.
start, endstring / nullISO-style source values: YYYY-MM-DD, YYYY-MM-DDTHH:mm:ss or a UTC value ending in Z. end is only the explicit DTEND.
allDayboolean / nullTrue for a date-only DTSTART, false for a timed DTSTART, null if DTSTART is absent.
timeZone, endTimeZonestring / nullOriginal start and end TZIDs, UTC for a Z value, or null for a floating or date-only value.
durationstring / nullThe explicit ICS duration, such as PT45M or P2D. It is not used to invent an end.
location, description, status, urlstring / nullSelected event details. Escaped punctuation and line breaks are decoded; HTML and links remain text.
rrule, exrulestring[]Repeat and legacy exclusion-rule strings. Series are not expanded into dates.
exdate, rdateobject[]Each value has value, type, timeZone and range. A period value is a two-item array containing its start and its end or duration.
recurrenceIdobject / nullThe same date-value shape, identifying the original occurrence for an exception. RANGE is retained when present.
organizer, attendeesobject / null; object[]Each contact has value and parameters. Addresses keep their mailto: prefix; parameter names are lowercase.
categoriesstring[]All category values, with escaped punctuation decoded.

These event objects use an application schema. They are different from jCal, the standard JSON representation of iCalendar. Calendar-level settings, embedded time zone definitions, alarms, attachments and custom properties are outside this export. Keep the ICS when you need a complete calendar backup or round-trip conversion.

Dates and time zones stay explicit

UTC, named zones and floating time

A value such as 2026-11-16T14:30:00Z is UTC. A New York event keeps 2026-11-16T09:30:00 and America/New_York separately. A time without a TZID or Z stays floating with a null zone. The converter does not apply your browser’s time zone or the calendar-wide X-WR-TIMEZONE hint.

All-day events and durations

Date-only values stay dates. An all-day end remains exclusive, following the iCalendar event definition. An absent end stays null. When a file supplies DURATION, that value is exported separately so your code can apply the appropriate calendar and daylight-saving rules.

Invalid dates get your attention

An impossible source date stops conversion and identifies its event number and field. It is not shifted to another day or silently left out. A missing DTSTART is retained as null and called out in the conversion notes. For a fuller file check, use the ICS Validator.

Keep recurring events connected

A weekly meeting is one record with an rrule array. Skipped dates go in exdate; additional dates and periods go in rdate. Each date entry retains its value, type, timeZone and range. A period has a two-item value array, such as a start date-time and PT1H.

A moved occurrence remains another object with its original UID and a recurrenceId. Cancellations keep their status. Your application decides how to expand the series and apply these exceptions. To explore a repeat pattern, use the RRULE Generator; to browse occurrences on a calendar, use the ICS Viewer.

Use calendar data in your own workflow

ICS to JSON is useful when you need event data for a script, a dashboard, a migration review or an application fixture. Folded ICS lines and escaped punctuation are decoded for you. Organizer and attendee parameters remain alongside their addresses, so you can inspect names and participation status without splitting raw calendar lines.

Review the field guide before mapping the array to an API or database. An API may require another schema, and the JSON does not connect to a calendar account or update later. For spreadsheet analysis, use ICS to CSV or Excel. For a readable document, use ICS to PDF.

Conversion happens locally without an account. File contents, filenames and event details are not uploaded or saved in browser storage. HTML and URLs remain text in the preview. Review attendee addresses and private meeting details before sharing the JSON.

Your file, draft, JSON and temporary example backup stay in this tab’s memory while you browse this website. Clear calendar removes them. Copy or download before refreshing or closing the tab, which clears that memory. Official reference links open in a new tab so you can keep the converter open. See our privacy policy for website analytics.

ICS to JSON questions

How do I convert ICS to JSON?

Choose or drop one .ics or .ical file. It converts automatically. To use calendar text, select Paste ICS, paste the complete calendar including BEGIN:VCALENDAR and END:VCALENDAR, and select Convert to JSON. Review the JSON on this page, then copy it or download a .json file. Pretty print changes the spacing of the preview, copied text and download together.

Is this ICS to JSON converter free and private?

Yes. No account, payment, AI credits or calendar connection is required. File reading, parsing and JSON generation happen in your browser. Calendar contents and filenames are not uploaded to our server or an AI provider, and are not saved in browser storage. Copy JSON writes the result to your clipboard. General website analytics record actions and event counts without calendar details.

What JSON format does this tool produce?

The result is a top-level array with one object per VEVENT record, in source order. Each object has the documented keys, including uid, summary, start, end, allDay, timeZone, recurrence fields, organizer and attendees. Missing optional values are null, lists are empty arrays, and a missing summary is an empty string. The field guide defines this application schema. Map it to your API's format before sending it, and keep the original ICS for a complete calendar backup.

Are dates converted to my local time zone?

No. A UTC date-time keeps its trailing Z and timeZone is UTC. A named-zone time keeps its wall-clock value and its original TZID in timeZone. A floating time keeps its value with timeZone set to null; the calendar-wide X-WR-TIMEZONE hint is not applied. All-day values stay YYYY-MM-DD with allDay set to true and no time zone. endTimeZone describes DTEND separately. VTIMEZONE definitions are not included in the JSON.

Why does an all-day event end on the following date?

ICS uses an exclusive DTEND: a weekend covering November 21 and 22 ends on November 23. This converter keeps that boundary for code to interpret. It does not subtract a day or create an end when the file omits DTEND. If the file specifies DURATION instead, end is null and duration keeps the explicit value, such as PT45M. Apply the duration with a calendar-aware library when you need a computed end.

What happens to recurring events and changed meetings?

A series remains one object with its rrule strings. A rule with COUNT=4 still counts as one event record in the preview; its four dates are not expanded. exdate holds skipped dates, rdate holds additional dates or periods, and recurrenceId identifies a separately exported exception. These date fields retain their value type, timeZone and any RANGE parameter. A changed or canceled occurrence remains its own record with the original UID and status. Duplicate records are retained.

Does it include attendees, reminders and custom properties?

Organizer and attendee addresses are included with their property parameters, such as cn, role and partstat. Categories, locations, descriptions, status and event URLs are included too. Calendar-level settings, time zone definitions, reminders, attachments, custom properties and other fields outside the field guide are omitted. Tasks, journal entries and free/busy components are not exported. Conversion notes identify non-event and nested components left out.

What are the file and processing limits?

Open one UTF-8 .ics or .ical file up to 2 MB, with at most 5,000 top-level event records, 50,000 lines, 64 KB per unfolded property and 16 nesting levels. JSON output is limited to 16 MB and conversion has a ten-second limit. Extract ZIP exports before choosing a file. A limit or unreadable date stops conversion with a message; the tool does not silently skip invalid events. A record without DTSTART is retained with null start and allDay values and a note.

Why are Copy JSON and Download JSON disabled?

Both actions wait until conversion finishes. After you edit pasted ICS, select Convert to JSON to update the result, or Discard changes to return to the last converted source. Until then the preview shows the previous JSON. An invalid replacement leaves your previous calendar in place. Try example keeps your calendar and draft, even while you convert or edit the example; Restore your calendar brings them back. The file, draft and result stay in this tab while you browse other pages on this website. Clear calendar removes them and the example backup; refreshing or closing the tab clears them too.

Can I convert JSON back to ICS or import this JSON into Google Calendar?

This page converts in the ICS-to-JSON direction. Google Calendar, Outlook and Apple Calendar import ICS files rather than this event-object array. Use the original ICS for a calendar import. If you are creating events from an application, map these fields to that application's documented API format. For manual event creation use the ICS File Generator; for spreadsheet data use CSV to ICS.

Open ICS File Generator · Open CSV to ICS