Your agent's own calendar.
No Google account. No OAuth dance. No human in the loop. Agents create events via API. A public iCal feed URL is generated instantly.
Calendar apps are built for humans
Every major calendar API assumes the entity scheduling the meeting is a human with a Google account. That assumption breaks the moment an AI agent needs to manage time.
Your agent needs to schedule. It should take one API call.
How it works
Three steps. Your agent handles all three.
Agent creates events via JSON API
POST /v1/calendar/events with summary, start, end. Optional: description, location, attendees. Returns the event ID immediately.
Public iCal feed URL generated automatically
Every account gets a permanent https://api.agentlair.dev/v1/calendar/feed.ics?cal_token=... URL. No configuration needed — it exists from the moment you create your account.
Users subscribe from their existing calendar app
Paste the iCal URL into Google Calendar → “Other calendars › From URL”. Events appear within minutes. No app install. No account creation. Works on every device.
Get started in 60 seconds
Pick your tool:
# 1. Get an API key (30 seconds)
API_KEY=$(curl -s -X POST https://api.agentlair.dev/v1/auth/keys | jq -r .api_key)
# 2. Create an event
curl -s -X POST https://api.agentlair.dev/v1/calendar/events \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"summary": "Product demo — Acme Corp",
"start": "2026-04-01T14:00:00Z",
"end": "2026-04-01T15:00:00Z",
"description": "Quarterly review call",
"location": "https://meet.example.com/demo"
}'
# -> { "id": "evt_01JNXK...", "summary": "Product demo — Acme Corp", ... }
# 3. Get the public iCal subscription URL
curl -s https://api.agentlair.dev/v1/calendar/feed \
-H "Authorization: Bearer $API_KEY"
# -> { "feed_url": "https://api.agentlair.dev/v1/calendar/feed.ics?cal_token=..." }
# 4. Share feed_url with anyone — they add it to their calendar app, doneCompatible with everything
The feed is a standard iCalendar file (RFC 5545). If it speaks iCal, it subscribes.
Building a calendar integration? Open a PR →
Key features
Agent-owned identity
No Google account. No user OAuth. Your agent is the calendar owner — events appear under its name, not yours.
Email invite notifications
Add attendees to any event. Invite emails sent automatically via AgentLair Email — no SMTP setup required.
iCal standard (RFC 5545)
Events rendered as valid VEVENT blocks. All-day events, date-time events, UTC and floating times all supported.
Vault integration
Store Google/Outlook OAuth tokens in Vault, use them to write to a user’s calendar — without touching your own infra.
Pricing
Free
- ✓100 events
- ✓Public iCal feed URL
- ✓Email invites (via AgentLair Email)
- ✓All calendar clients
- ✓No credit card required
Starter
Popular- ✓10,000 events
- ✓Multiple calendars per account
- ✓Event filtering by date range
- ✓x402 autonomous payments
- ✓Priority support
Free tier is permanent — no expiry, no bait-and-switch.
Autonomous agents: x402 payments available — agents pay per-call at $0.001/request when limits are hit.
What’s included
Built on open standards. No vendor lock-in, no proprietary format.
Why not just use…?
vs Google Calendar API
Requires a human OAuth consent flow. No service account path for consumer accounts. Domain-wide delegation needs Google Workspace ($6+/user/mo).
vs Cronofy / Nylas
Connect to existing human calendars — they don’t provision new ones. Enterprise pricing. We give your agent its own calendar with one API call.
vs Cal.com
Scheduling platform for humans, not agents. Requires a UI and a human on the other side. We’re infrastructure — your agent is in control.
vs self-hosted CalDAV
Radicale/Baikal require persistent storage, ops, and deployment. We handle the infra — your agent gets a calendar endpoint, not a server to manage.
API reference
| Method | Endpoint | Description |
|---|---|---|
POST | /v1/calendar/events | Create an event (body: summary, start, end, description?, location?, attendees?) |
GET | /v1/calendar/events | List events (?from=ISO&to=ISO optional date range filter) |
DELETE | /v1/calendar/events/{id} | Delete a single event by ID |
GET | /v1/calendar/feed | Get (or create) public iCal subscription URL |
GET | /v1/calendar/feed.ics | Public iCal feed (?cal_token=, no auth required) |
Your agent’s own calendar.
Free tier. No Google account. No OAuth. No human setup.
API reference · Dashboard · Email · Vault
Explore more
Get API Key — Free
Create an account in 30 seconds. No credit card, no OAuth, no human setup.
Store OAuth Tokens in Vault
Securely store Google/Outlook tokens for writing to user calendars.
Framework Integrations
LangChain, CrewAI, Vercel AI SDK, Claude MCP — works with everything.
Agent Email
Give your agents a real email address. Claim @agentlair.dev in 30 seconds.