mykal for developers.

Build integrations, AI agents, and companion apps on top of mykal. The API covers routine tasks, scheduling runs, calendar events, webhook endpoints, reminders, and admin. Every outbound webhook is HMAC-signed and replay-protected.

10-minute quickstart Get API key OpenAPI spec

API keys are not yet exposed via the settings UI as a first-class sub-page — for now the "Get API key" CTA deep-links into the settings page anchor; contact support if you need a scoped key issued before the UI lands.

Reference sections

Quickstart

Register, connect a calendar, make your first task via curl, and receive your first signed webhook through ngrok — under 10 minutes.

API reference

Every HTTP endpoint grouped by router. Auth, params, examples, status codes. Dual-mounted under /api/v1 and /v1.

Webhooks

Event envelope, HMAC-SHA256 signing spec, replay protection, retry policy, and verification code in 6 languages.

AI agent integration

Build an agent that receives a reminder, decides, and acts on tasks. Patterns, auth, cost, and a full Python reference agent.

SDK examples

Working Python, Node/TypeScript, and Go client samples — plus curl recipes for every common operation.

OpenAPI schema

Download the OpenAPI JSON for codegen. Snapshot available for production; live spec available in dev.

Dual-mount note: every endpoint documented here is also served under /v1/* (no /api prefix). Either is stable. The /api/v1/* form is the canonical one used in all examples.