Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@agents-calendar what's on my calendar tomorrow?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
pip install agents-calendar && agents-calendar sync --initMerges MCP into host configs. Prints where credentials go. Does not write secrets into mcp.json. init is the same command.
🤖 Agent-Driven Setup: Give your coding agent this repo (clone or URL), then tell it to "install and set up agents-calendar."
Source checkouts can also be installed and managed with vand.
Related MCP server: Oreo Pudding
List calendars, list events in a time range, add, update, delete. Recurrence rules stay on the CalDAV server (time-range report). Writes send If-None-Match: * on create and If-Match on update and delete, so a stale etag does not clobber.
The password is never printed, logged, or returned by a tool.
Highest priority first:
Process env: CALDAV_URL, CALDAV_USERNAME, CALDAV_PASSWORD
~/.agents/calendar.json (mode 0600)
~/.agents/.env keys CALDAV_*
{
"url": "https://example.com/dav/calendars/user/calendar/",
"username": "user",
"password": "app-password"
}CLI and MCP both read this file, so a desktop host does not need the password in its MCP config. A URL that is only a host or principal is resolved through calendar-home-set. add writes into a VEVENT collection, not a reminder collection.
Floor: any MCP client or a terminal. python -m agents_calendar serve is enough. No skills are installed.
Layer | What you get | Who |
CLI + MCP | The five tools below, or the same verbs on the CLI | Any MCP host / any shell |
Autowire |
| Cursor, Claude Desktop, Zed ( |
MCP without autowire: point the host at python -m agents_calendar serve.
Primary surface. They mirror the CLI. Password never appears in the JSON.
Tool | What it does |
| Collections under the configured URL |
| VEVENTs between ISO |
| Create. |
| Replace. |
| Delete. Same |
Five tools.
Machine-readable catalog: python -m agents_calendar --help-json (do not scrape --help).
Command | Purpose |
| Merge MCP. Alias: |
| List collections |
| Events in that range |
| Create. Optional |
| Replace fields you pass |
| Delete |
| stdio MCP. Not the default |
No subcommand prints help.
Contract in abi/:
WHY.md — server-side recurrence and etags
LAYOUT.md — credential file
MCP.md — five tools
CLI.md — the same verbs, plus init
python -m unittest discover testsMIT. See LICENSE.
This server cannot be deployed
Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.
Connects ChatGPT to your Apple Calendar via a local Mac agent + Vercel relay
Agent-Native Google Calendar - manage events, sync, and public booking
GDPR-compliant calendar access for AI assistants: read, create, edit, RSVP. Google, MS 365, Apple.
