Developer documentation

MagiCal for Muse

The MagiCal connector turns schedule text, paper-calendar images, and handwriting into draft calendar events. People always review, edit, select, and approve events before anything reaches a calendar.

API endpoint

POST https://magi-cal.com/api/muse/events

Send JSON with exactly one of text or image_data_url. Optional fields are source_name and instructions.

Authentication

Use an API key issued privately by MagiCal in the HTTP header Authorization: Bearer YOUR_API_KEY. Never place the key in a URL or client-side application.

Human approval is required

The API returns draft events, confidence levels, and uncertain fields. The response always sets review_required to true and links to MagiCal so the person can inspect the source, correct details, choose which events to keep, and export only those events.

Supported inputs

• Spoken or typed schedule text
• JPEG, PNG, or WEBP calendar images supplied as data URLs
• Printed monthly calendars and handwritten schedules
• An optional plain-language filter, such as “only games and practices”

Limits and safety

• Images are limited to 10 MB and requests are rate limited.
• Only supported image formats are accepted.
• Recognition uncertainty is surfaced rather than silently guessed.
• The connector never writes directly to a calendar.

Specification and help

OpenAPI 3.1 specification · Support · Privacy policy · Terms of service · Data deletion

Connector documentation updated September 19, 2026.