mcp server

Chronary

Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.

Description as published by the maintainer. Source

• version 1.5.2
• active

active — Most recent push to the repository was 2026-07-14.

What this server can do

54 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

accept_terms(tos_version)

Re-accept the current Chronary terms of service on behalf of the calling org. Use this when responses carry the Chronary-Terms-Upgrade-Required header — a material ToS bump otherwise leaves MCP-only agents stuck without a console session. Pass the current tos_version (read it from GET /v1/auth/terms/current). Requires an org-level API key (chr_sk_*); agent-scoped keys cannot accept org-wide terms. Required: tos_version.

cancel_connection_link(connection_link_id)

Cancel a pending human-calendar setup request. This invalidates the setup URL and does not disconnect an already completed Google or Microsoft connection. Required: connection_link_id.

cancel_event(event_id, calendar_id, occurrence_start)

Delete or cancel an event from a calendar. Use this to remove, cancel, or delete any scheduled event or appointment. The event is marked cancelled and excluded from future availability calculations. For a recurring series, pass `occurrence_start` to cancel just that one occurrence (the series continues); omit it to cancel the whole series. `calendar_id` is optional — if omitted the calendar is looked up from the event. Provide `calendar_id` to fail fast on cross-calendar typos. Required: event_id.

cancel_proposal(proposal_id)

Cancel an open proposal. Fires a proposal.cancelled webhook with reason="organizer_cancelled". Requires an org-level API key. Pro plan only. Required: proposal_id.

clear_availability_rules(calendar_id)

Remove the availability rules from a calendar, reverting to the default (no buffers, no working-hours mask). Returns the deleted row, or an error if none were set. Required: calendar_id.

confirm_event(event_id)

Promote a held event to a confirmed booking. The event must currently have status="hold" and its hold_expires_at must not have passed. After confirmation, event.started and event.ended lifecycle webhooks fire at the scheduled times. Required: event_id.

create_agent(name, type, description)

Register your agent (AI assistant, human participant, or resource) with Chronary so it can own calendars, events, and webhooks. Required: name, type.

create_booking_page(title, active, timezone, calendar_id, description, window_days, buffer_minutes, duration_minutes, min_notice_minutes, availability_constraints)

Create a public booking page (a hosted scheduling link) for a calendar. Returns a booking_url to send to a human; when they pick a slot, a confirmed event is created on the calendar and an event.created webhook fires with a booking_page_id field. Set availability_constraints to restrict to weekly working hours; existing calendar events always block slots. Required: calendar_id, title.

create_calendar(name, agent_id, timezone, default_reminders)

Create a calendar to hold events and track availability. Calendars are required before creating events — call this first when setting up a new agent. An agent can have multiple calendars (e.g. "Work", "Personal"). Org-level calendars (no agent_id) can be used as shared resources like meeting rooms. Required: name, timezone.

create_connection_link(calendar_id, capabilities, publication_policy)

Request human setup of Google Calendar or Microsoft Outlook for a Chronary calendar. Give setup_url to a human; the agent never receives OAuth credentials, provider calendar names, or event data. The secret URL is returned only on first creation. If reused=true and setup_url is null, retain the original URL or cancel this link and create a replacement. Required: calendar_id.

create_event(title, status, all_day, end_time, reminders, start_time, calendar_id, description, hold_priority, hold_expires_at, recurrence_rule)

Create a booking, appointment, meeting, hold, or any scheduled event on a calendar. The calendar_id comes from create_calendar or list_events. Once created, this event blocks the agent's availability during that time and appears in availability queries. Use status="hold" with hold_expires_at to tentatively reserve a slot that auto-releases on TTL. Required: calendar_id, title, start_time, end_time.

create_proposal(slots, title, expires_at, calendar_id, description, organizer_agent_id, participant_agent_ids)

Create a scheduling proposal — send a set of candidate time slots to one or more participant agents so they can accept, decline, or counter-propose. The organizer agent owns the proposal; once every participant responds, the system auto-resolves to the highest-scoring slot (or cancels if all decline). Requires an org-level API key. Pro plan only. Required: title, organizer_agent_id, participant_agent_ids, calendar_id, slots.

create_scoped_key(label, agent_id)

Create an agent-scoped API key (chr_ak_*) that can only act on behalf of a single agent. Use this to self-provision or rotate per-agent credentials. The plaintext key is returned exactly once in the response — store it immediately, it cannot be retrieved later. Requires an org-level API key. Required: agent_id.

create_webhook(url, events)

Create a webhook subscription so the org receives HTTP POST notifications when events occur (e.g. event.created, proposal.confirmed). The signing secret is returned ONCE in this response — store it to verify the HMAC-SHA256 signature on delivered payloads. Requires an org-level API key. Required: url, events.

delete_agent(agent_id)

Decommission an agent. This marks the agent as decommissioned and revokes all of its scoped API keys. Requires an org-level API key — agent-scoped keys cannot delete agents. Required: agent_id.

delete_booking_page(booking_page_id)

Delete (deactivate) a booking page. Its hosted URL stops resolving; already-booked events are unaffected. Required: booking_page_id.

delete_calendar(calendar_id)

Delete a calendar (soft delete). Its events are no longer returned and it stops contributing to availability. Agent-scoped keys may only delete calendars owned by their agent. Required: calendar_id.

delete_ical_subscription(subscription_id)

Delete an external iCal feed subscription. Events previously synced from the feed are no longer refreshed. Required: subscription_id.

delete_webhook(webhook_id)

Permanently delete a webhook subscription. This frees its endpoint slot against the per-plan cap. Requires an org-level API key. Required: webhook_id.

find_meeting_time(end, start, agents, duration, end_time, agent_ids, calendars, start_time, include_busy, slot_duration)

Find slots when multiple agents are free across Chronary calendars and any human calendars authorized for each agent. This tool is fail-closed: always inspect `availability_state` and `warnings` before using slots. Accepts `agents`/`start`/`end` or their aliases.

get_agent(agent_id)

Fetch a single agent by ID. An agent represents an AI assistant, human, or shared resource (e.g. a meeting room). Agent-scoped API keys may only read their own agent. Required: agent_id.

get_audit_log(to, from, limit, action, cursor, actor_key_prefix)

List audit-log entries for the calling org — mutating operations and auth-lifecycle events, newest first. Results are clamped to the plan's retention window. Requires an org-level API key (chr_sk_*); agent-scoped keys cannot read the org-wide audit log.

get_availability(end, start, agent_id, duration, end_time, start_time, include_busy, slot_duration)

Check when a single agent is free across its Chronary calendars and any human calendars authorized for that agent. This tool is fail-closed: always inspect `availability_state` and `warnings` before using slots. Accepts `start`/`end` or the `start_time`/`end_time` aliases. Required: agent_id.

get_availability_rules(calendar_id)

Read the buffer times and working-hours rules configured on a calendar. Returns the rules row, or an error if none are set. Required: calendar_id.

get_booking_page(booking_page_id)

Fetch a single booking page by ID, including its public booking_url and settings. Required: booking_page_id.

get_calendar(calendar_id)

Fetch a single calendar by ID, including its name, timezone, agent status, and default reminders. Agent-scoped keys may only read calendars owned by their agent. Required: calendar_id.

get_calendar_context(calendar_id)

Get a calendar's temporal context in a single call: the current event (if one is happening now), the next upcoming event, recent past events, a short upcoming window, and the owning agent's status (idle/working/waiting/error). Use this to answer "what is this agent doing right now?" without issuing multiple list_events queries. Required: calendar_id.

get_connection_link(connection_link_id)

Poll a human-calendar setup request. Returns provider-neutral status and resulting connection ID when complete, but never replays the bearer setup URL or exposes human calendar data. Required: connection_link_id.

get_event(event_id, calendar_id)

Retrieve a single event by ID, including its title, times, status, location, reminders, and metadata. Works for both internally created events and externally synced iCal events. `calendar_id` is optional — if omitted the calendar is resolved from the event. Provide `calendar_id` to fail fast on cross-calendar typos. Required: event_id.

get_ical_subscription(subscription_id)

Get a single external iCal feed subscription by id, including its sync status, last sync time, and last error. Required: subscription_id.

get_proposal(proposal_id)

Get a scheduling proposal by id, including its slots and per-participant responses. Requires an org-level API key. Required: proposal_id.

get_usage

Get the calling org's current-period usage and plan limits (agents, calendars, events, API calls, webhooks, availability queries, iCal subscriptions, proposals, scoped keys, holds, cross-calendar queries). Requires an org-level API key (chr_sk_*); agent-scoped keys cannot read org-wide usage.

get_webhook(webhook_id)

Get a single webhook subscription by id, including its subscribed event types and active state. The signing secret is never returned. Requires an org-level API key. Required: webhook_id.

list_agents(type, limit, offset, status)

List all agents in your organization

list_booking_pages(limit, offset)

List booking pages in the org. Agent-scoped keys see only pages on their own agent's calendars.

list_calendars(limit, offset, include, agent_id)

List calendars in the org. Org-level API keys see every calendar (agent-owned and shared); agent-scoped keys see only their own agent's calendars. Use this to discover calendar IDs before creating or listing events.

list_events(limit, expand, offset, source, status, agent_id, calendar_id, start_after, start_before)

List events on a calendar or across an agent's calendars, including internally created events and externally synced events from iCal subscriptions (e.g. Google Calendar, Outlook). Provide `calendar_id` OR `agent_id`. Narrow with `start_after`/`start_before` (time window), `status`, and `source`.

list_ical_subscriptions(limit, offset, status, agent_id)

List an agent's external iCal feed subscriptions (e.g. linked Google Calendar / Outlook feeds), including their sync status and last sync time. Required: agent_id.

list_proposals(limit, offset, status, organizer_agent_id)

List scheduling proposals for the org. Filter by status (pending|confirmed|expired|cancelled) or organizer_agent_id. Requires an org-level API key.

list_scoped_keys

List all live (non-revoked) agent-scoped API keys for this org. Returns key metadata only (id, prefix, agent_id, label, created_at) — never the plaintext secret. Requires an org-level API key.

list_webhook_deliveries(limit, offset, status, webhook_id, include_payload)

List delivery attempts for a webhook subscription, with per-status counts (pending/delivered/failed). Use this to debug failing deliveries. Requires an org-level API key. Required: webhook_id.

list_webhooks(limit, offset)

List the org's webhook subscriptions with their subscribed event types and active state. Signing secrets are never returned. Requires an org-level API key.

release_event(event_id)

Manually release a held event before its hold_expires_at. The event must currently have status="hold". Frees the slot for other agents to book. Required: event_id.

resolve_proposal(proposal_id)

Force-resolve an open proposal using responses collected so far. Picks the highest-scoring slot among those accepted by the most participants and creates a confirmed calendar event. If every response was "decline", the proposal is cancelled instead. Use when you want to close out a proposal without waiting for every participant. Requires an org-level API key. Pro plan only. Required: proposal_id.

respond_to_proposal(message, agent_id, response, proposal_id, counter_slots, selected_slot_id)

Submit a response (accept / decline / counter) on behalf of one participant agent to an open proposal. An "accept" requires the slot id from the proposal; a "counter" can suggest alternative slots. When all participants have responded the proposal auto-resolves — no separate resolve call needed in the normal flow. Requires an org-level API key. Pro plan only. Required: proposal_id, agent_id, response.

revoke_scoped_key(key_id)

Revoke an agent-scoped API key by ID. Revocation is permanent (cannot be un-revoked); the key stops authenticating within about a minute. Requires an org-level API key. Required: key_id.

set_availability_rules(timezone, calendar_id, working_hours, buffer_after_minutes, buffer_before_minutes)

Set or replace the availability rules on a calendar — buffer times before/after events and optional per-day working hours. When these rules are set, every availability query on this calendar automatically applies them (busy-block expansion for buffers, masking outside working hours). Upsert: overwrites any existing rules. Required: calendar_id.

subscribe_ical(url, label, agent_id, calendar_id)

Link an external iCal feed (e.g. a human's Google Calendar) to an agent's calendar so external events appear in availability calculations. The target calendar must be owned by the specified agent — create the calendar with that agent_id first (org-level calendars without an agent_id cannot host external iCal subscriptions; create a dedicated per-agent calendar for sync targets). Required: agent_id, calendar_id, url.

sync_ical_subscription(subscription_id)

Trigger an immediate sync of an external iCal feed subscription instead of waiting for the next scheduled poll. Returns once the sync has been queued. Required: subscription_id.

update_agent(name, status, agent_id, metadata, description)

Update an agent's name, description, metadata, or status (active/paused). Requires an org-level API key — agent-scoped keys cannot mutate agents. Required: agent_id.

update_calendar(name, metadata, timezone, calendar_id, agent_status, default_reminders)

Update a calendar's name, timezone, agent status, default reminders, or metadata. Agent-scoped keys may only update calendars owned by their agent. Required: calendar_id.

update_event(title, status, all_day, end_time, event_id, metadata, reminders, start_time, calendar_id, description, recurrence_rule)

Reschedule or edit an event — change its title, description, start/end times, location, status, reminders, or metadata. Use this to move an appointment to a new time or update its details. Provide only the fields you want to change. Holds cannot be edited via this tool (use confirm_event / release_event). External iCal events are read-only. `calendar_id` is optional — if omitted it is resolved from the event. Required: event_id.

update_ical_subscription(url, label, subscription_id)

Update an external iCal feed subscription — change its label or its feed URL. Changing the URL forces a full re-sync on the next poll. Required: subscription_id.

update_webhook(url, active, events, webhook_id)

Update a webhook subscription — change its delivery URL, the set of subscribed event types, or pause/resume it via active. At least one field must be supplied. Requires an org-level API key. Required: webhook_id.

Last successful function declaration observed on 2026-08-13. Source: https://api.chronary.ai/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://api.chronary.ai/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/Chronary/chronary-mcp
• Website — https://docs.chronary.ai/mcp/overview
• npm: @chronary/mcp
• Remote endpoint (streamable-http) — https://api.chronary.ai/mcp