Calendar
Events from any calendar with an iCal link, including repeating events.
Server URL
ical.mcp.zahraabouzeid.me /mcpReads the events of one calendar for a range of days, with repeating events listed once per date. It works with any calendar that offers an iCal or webcal link, such as Google Calendar, Outlook or a university timetable.
Connect
In Claude, open “Customize” and select “Connectors”.
Select “Add custom connector”, paste the URL and select “Add”.
https://ical.mcp.zahraabouzeid.me/mcpSelect “Connect” and complete the sign-in page.
On the free plan, you can add one custom connector. On Team and Enterprise plans, an owner first adds the connector in “Organization settings” > “Connectors”.
In ChatGPT on the web, open “Settings” > “Connectors” > “Advanced” and turn on “Developer mode”.
Select “Create”, enter a name, paste the URL and set authentication to “OAuth”.
https://ical.mcp.zahraabouzeid.me/mcpIn a new chat, open the “+” menu, select “Developer mode” and turn on the connector.
Developer mode requires a paid plan. OpenAI sometimes moves these settings, so the names may differ.
Run this command in your terminal:
claude mcp add --transport http ical https://ical.mcp.zahraabouzeid.me/mcpThen run this command in Claude Code, select “ical” and sign in in your browser:
/mcp
Run this command in your terminal:
codex mcp add ical --url https://ical.mcp.zahraabouzeid.me/mcpThen run this command and sign in in your browser:
codex mcp login ical
Run this command in your terminal:
gemini mcp add --transport http ical https://ical.mcp.zahraabouzeid.me/mcpThen run this command in Gemini CLI and sign in in your browser:
/mcp auth ical
Tools
list_events- Lists the events of the connected calendar for a range of days.
These tools can only read data. They can't change or send anything.
Sign in
When you connect, a page asks for your calendar's iCal or webcal link.
Your details are encrypted, stored on the server and deleted after 90 days without use. The server's operator can technically access them, so only connect accounts you're comfortable with.
The source code is on GitHub in ical-mcp under the AGPL-3.0 license.