Skip to main content

cordova-plugin-calendar Alternative for Capacitor

cordova-plugin-calendar alternative for Capacitor: create, list, modify and delete native calendar events with @capgo/capacitor-calendar and iOS Reminders support.

Illustration of migrating a Cordova app to Capacitor, used for a calendar plugin guide

The practical cordova-plugin-calendar alternative for a Capacitor app is @capgo/capacitor-calendar. It maps window.plugins.calendar callbacks on Calendar.js to CapacitorCalendar promises, adds typed permission helpers for iOS 17 calendar access levels, and covers iOS Reminders APIs that the Cordova plugin never shipped. This guide lists npm facts, install steps, usage, and an API map for your Cordova to Capacitor move.

Why leave cordova-plugin-calendar in Capacitor

cordova-plugin-calendar on npm is version 5.1.6. The registry modified timestamp is 13 June 2022. Version 5.1.6 was published 11 January 2022. The npm repository URL points to EddyVerbruggen/Calendar-PhoneGap-Plugin.

The www/Calendar.js source exposes window.plugins.calendar with methods including:

  • Permission helpers: hasReadPermission, requestReadWritePermission, and related callbacks
  • createEvent, createEventWithOptions, createEventInteractively, createEventInteractivelyWithOptions
  • findEvent, findEventWithOptions, listEventsInRange, listCalendars
  • modifyEvent, modifyEventWithOptions, deleteEvent, deleteEventById
  • createCalendar, deleteCalendar, openCalendar
  • Positional arguments: title, location, notes, JavaScript Date startDate and endDate

In a Capacitor codebase the Cordova plugin still depends on cordova.exec, converts dates to epoch milliseconds in JavaScript, and mixes Android calendarId with iOS calendarName in option bags.

@capgo/capacitor-calendar latest on npm is 8.0.17 with a modified date of 12 November 2026. src/definitions.ts documents createEvent, createEventWithPrompt, modifyEvent, deleteEvent, listEventsInRange, listCalendars, getDefaultCalendar, createCalendar, deleteCalendar, modifyCalendar, openCalendar, and iOS createReminder / getRemindersFromLists helpers. Capgo ships fixes on an open source cadence where a human still reviews, tests and merges 50+ pull requests daily.

Install

bun add @capgo/capacitor-calendar
bunx cap sync

On iOS set the calendar and reminders usage description keys your app needs in Info.plist. On Android add READ_CALENDAR and WRITE_CALENDAR when you use silent reads and writes, not only createEventWithPrompt.

Usage example

import { CapacitorCalendar } from '@capgo/capacitor-calendar';

export async function addSilentEvent() {
  const access = await CapacitorCalendar.requestFullCalendarAccess();
  if (access.result !== 'granted') {
    throw new Error('Calendar permission denied');
  }

  const startDate = Date.now() + 3_600_000;
  const endDate = startDate + 3_600_000;

  const { id } = await CapacitorCalendar.createEvent({
    title: 'Site visit',
    location: 'Warehouse 4',
    notes: 'Bring safety gear',
    startDate,
    endDate,
    alerts: [60],
  });

  return id;
}

Migrating from Cordova to Capacitor

// Before (Cordova silent create)
var startDate = new Date(2025, 2, 15, 18, 30, 0, 0, 0);
var endDate = new Date(2025, 2, 15, 19, 30, 0, 0, 0);
window.plugins.calendar.createEvent(
  'My event',
  'Home',
  'Notes',
  startDate,
  endDate,
  success,
  error,
);
// After (Capacitor)
import { CapacitorCalendar } from '@capgo/capacitor-calendar';

await CapacitorCalendar.requestFullCalendarAccess();
await CapacitorCalendar.createEvent({
  title: 'My event',
  location: 'Home',
  notes: 'Notes',
  startDate: new Date(2025, 2, 15, 18, 30, 0, 0).getTime(),
  endDate: new Date(2025, 2, 15, 19, 30, 0, 0).getTime(),
});
// Before (Cordova list in range)
window.plugins.calendar.listEventsInRange(startDate, endDate, success, error);
// After (Capacitor)
const { result } = await CapacitorCalendar.listEventsInRange({
  from: startDate.getTime(),
  to: endDate.getTime(),
});

API mapping table

cordova-plugin-calendar (window.plugins.calendar) @capgo/capacitor-calendar
requestReadWritePermission(...) requestFullCalendarAccess() or granular requestWriteOnlyCalendarAccess / requestReadOnlyCalendarAccess
createEvent(title, location, notes, start, end, ...) createEvent({ title, location, notes, startDate, endDate, ... }) with millisecond timestamps
createEventWithOptions(..., options, ...) createEvent fields: alerts, recurrence, calendarId, url, etc.
createEventInteractively(...) createEventWithPrompt(...)
listEventsInRange(start, end, ...) listEventsInRange({ from, to })
listCalendars(...) listCalendars()
deleteEventById(id, fromDate, ...) deleteEvent({ id, ... })
deleteEvent(title, location, ...) deleteEvent by id when known, or deleteEventWithPrompt
modifyEvent(...) / modifyEventWithOptions(...) modifyEvent({ id, ...fields }) or modifyEventWithPrompt
findEvent / findEventWithOptions listEventsInRange plus filter in app code, or query by id when you stored it
openCalendar(date, ...) openCalendar({ date })
createCalendar(nameOrOptions, ...) createCalendar({ title, color, ... })
deleteCalendar(name, ...) deleteCalendar({ id }) (Capgo uses calendar id)
Not in Cordova iOS createReminder, getRemindersFromLists, openReminders
Cordova plugin install bun add @capgo/capacitor-calendar plus bunx cap sync

Calendar access and OS permission strings ship in the native binary, so plan a store build after you swap plugins. Use Capgo Build for cloud builds, then ship scheduling UI with Capgo live updates where the logic stays in JavaScript. For the full platform move, read the Cordova to Capacitor migration guide.

Live updates for Capacitor apps

When a web-layer bug is live, ship the fix through Capgo instead of waiting days for app store approval. Users get the update in the background while native changes stay in the normal review path.

Latest from our Blog

Capgo gives you the best insights you need to create a truly professional mobile app.