agents-calendar
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-calendarwhat'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.
agents-calendar
CalDAV feeler for agents. CLI and MCP. Events only (v0). Python stdlib HTTP plus mcp. No caldav / icalendar libraries. No CardDAV. No WebDAV files. No RRULE parser — the server expands recurrence via time-range.
Cursor (MCP) and Klanker (Cordis call_job) share this CLI. Credentials live in env, never in chat, traces, or markdown memory. The CLI never prints the password.
Install
python -m pip install -e .Python 3.10+. Depends on mcp.
Related MCP server: Oreo Pudding
Commands
Machine catalog: python -m agents_calendar --help-json (do not scrape --help).
export CALDAV_URL="https://example/dav/calendars/user/calendar/"
export CALDAV_USERNAME="user"
export CALDAV_PASSWORD="app-password"
python -m agents_calendar calendars
python -m agents_calendar list --from 2026-09-13T00:00:00Z --to 2026-09-14T00:00:00Z
python -m agents_calendar add --summary "Exam" --dtstart 2026-09-14T08:00:00Z --dtend 2026-09-14T10:00:00Z
python -m agents_calendar update --href <href> --etag <etag> --summary "Exam (moved)"
python -m agents_calendar delete --href <href> --etag <etag>
python -m agents_calendar serveCommand | Purpose |
| List collections under |
| VEVENTs in the range. Server expands recurrence |
| Create ( |
| Replace ( |
| Delete ( |
| FastMCP stdio |
MCP
Copy mcp.json.example into the host MCP config. Do not auto-merge ~/.cursor/mcp.json. Tools mirror the CLI: calendar_calendars, calendar_list, calendar_add, calendar_update, calendar_delete. Password never in responses.
Env
Variable | Role |
| Calendar collection URL |
| Basic auth user |
| App password. Never print it |
Constraints
Harness shells this CLI. It does not import this package.
Write uses
If-Match/If-None-Match.
Tests
python -m unittest discover -s tests -p "test_*.py"License
MIT. See LICENSE.
This server cannot be deployed
Maintenance
Related MCP Connectors
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.
Related MCP Servers
- FlicenseNot gradedqualityFmaintenanceEnables interaction with any CalDAV-compatible calendar server (Yandex, Google, Nextcloud, iCloud, etc.) to list calendars, create/manage events with reminders and attendees, search events, and handle recurring events through natural language.14-
- FlicenseNot gradedqualityDmaintenanceEnables LLM clients to interact with Apple Calendar (iCloud) via CalDAV, supporting listing calendars, retrieving, creating, updating, and moving events.-
- AlicenseNot gradedqualityCmaintenanceProvides read-only access to calendar events from iCal feeds, enabling agents to query schedules, search events, and check availability via natural language.AGPL 3.0
- FlicenseNot gradedqualityBmaintenanceEnables interacting with CalDAV calendars (like iCloud) through natural language, supporting reading and writing events.1-