How do I use iCal MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@iCal MCP Server list events from my work calendar this week" 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.

iCal MCP Server

by jnss95

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

iCal MCP Server

A modern Model Context Protocol (MCP) server for managing iCalendar files. This server allows AI assistants to interact with calendar data through a standardized protocol.

Features

Load calendars from:
- Local files (.ics)
- HTTP/HTTPS URLs
Query events with filters for:
- Date ranges
- Search text (summary, description, location)
- Location
- Recurring event expansion
Full CRUD operations:
- Create new events
- Update existing events
- Delete events
Multiple calendar support: Load and manage multiple calendars simultaneously
Read-only mode: HTTP calendars are automatically read-only

Related MCP server: Google Calendar MCP Server

Installation

Using npx (recommended)

You can run the server directly without installation:

npx @jonas/ical-mcp

Global Installation

npm install -g @jonas/ical-mcp
ical-mcp

Local Development

git clone https://github.com/jnss95/ical-mcp.git
cd ical-mcp
npm install
npm run build
npm start

Configuration

Environment Variables

Calendars are configured using environment variables at startup:

Variable	Description
`CALENDAR_LINK`	URL or path to a calendar (id defaults to "default")
`CALENDAR_LINK_{id}`	URL or path to a calendar with custom id

Examples:

Single calendar (id defaults to "default"):

CALENDAR_LINK=https://example.com/calendar.ics

Multiple calendars with custom IDs:

CALENDAR_LINK_work=https://example.com/work.ics
CALENDAR_LINK_personal=/path/to/personal.ics
CALENDAR_LINK_holidays=https://example.com/holidays.ics

VS Code MCP Configuration

Add to your VS Code settings (.vscode/mcp.json):

{
  "servers": {
    "ical": {
      "type": "stdio",
      "command": "npx",
      "args": ["@jnss95/ical-mcp"],
      "env": {
        "CALENDAR_LINK": "https://example.com/your-calendar.ics"
      }
    }
  }
}

With multiple calendars:

{
  "servers": {
    "ical": {
      "type": "stdio",
      "command": "npx",
      "args": ["@jnss95/ical-mcp"],
      "env": {
        "CALENDAR_LINK_work": "https://example.com/work.ics",
        "CALENDAR_LINK_personal": "/path/to/personal.ics"
      }
    }
  }
}

Claude Desktop Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "ical": {
      "command": "npx",
      "args": ["@jnss95/ical-mcp"],
      "env": {
        "CALENDAR_LINK": "https://example.com/your-calendar.ics"
      }
    }
  }
}

Available Tools

Calendar Management

Tool	Description
`list_calendars`	List all loaded calendars
`get_calendar_info`	Get metadata about a loaded calendar

Event Operations

Tool	Description
`list_events`	List all events in a calendar
`search_events`	Search events with filters
`get_event`	Get details of a specific event
`create_event`	Create a new event
`update_event`	Update an existing event
`delete_event`	Delete an event

Tool Examples

List Calendars

{
  "tool": "list_calendars",
  "arguments": {}
}

Search Events

{
  "tool": "search_events",
  "arguments": {
    "calendarId": "work",
    "startDate": "2024-01-01T00:00:00Z",
    "endDate": "2024-01-31T23:59:59Z",
    "searchText": "meeting",
    "expandRecurring": true
  }
}

Create Event

{
  "tool": "create_event",
  "arguments": {
    "calendarId": "work",
    "summary": "Team Meeting",
    "start": "2024-01-15T10:00:00Z",
    "end": "2024-01-15T11:00:00Z",
    "description": "Weekly team sync",
    "location": "Conference Room A"
  }
}

Create Recurring Event

{
  "tool": "create_event",
  "arguments": {
    "calendarId": "work",
    "summary": "Daily Standup",
    "start": "2024-01-15T09:00:00Z",
    "end": "2024-01-15T09:15:00Z",
    "rrule": "FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR"
  }
}

Update Event

{
  "tool": "update_event",
  "arguments": {
    "calendarId": "work",
    "eventId": "event-uid@example.com",
    "summary": "Updated Meeting Title",
    "location": "New Location"
  }
}

Development

Running Tests

# Run all tests
npm test

# Run tests with coverage
npm run test:coverage

# Run tests in watch mode
npm run test:watch

Building

# Build TypeScript
npm run build

# Watch mode
npm run watch

Project Structure

ical_mcp/
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── calendar/
│   │   ├── calendar.ts       # Calendar class (CRUD operations)
│   │   ├── loader.ts         # Calendar loading utilities
│   │   └── index.ts          # Module exports
│   └── types/
│       ├── calendar.ts       # Type definitions
│       ├── ical.d.ts         # ical.js type declarations
│       └── index.ts          # Type exports
├── build/                    # Compiled JavaScript
├── package.json
├── tsconfig.json
└── vitest.config.ts

License

MIT

Available Tools

8 tools

create_eventB

Create a new event in the calendar.

Inputs: start (required), summary (required), calendarId (required), end, +9 more.

delete_eventB

Delete an event from the calendar.

Inputs: eventId (required), calendarId (required).

get_calendar_infoA

Get metadata and information about a loaded calendar.

Inputs: calendarId (required).

get_eventA

Get detailed information about a specific event by its UID.

Inputs: eventId (required), calendarId (required).

list_calendarsA

List all currently loaded calendars.

Inputs: no named parameters.

list_eventsB

List all events in a calendar, optionally filtered by date range.

Inputs: calendarId (required), limit, offset, endDate, +2 more.

search_eventsC

Search for events matching specified criteria.

Inputs: calendarId (required), limit, endDate, location, +4 more.

update_eventC

Update an existing event.

Inputs: eventId (required), calendarId (required), end, url, +10 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.5/5.0

Scored 2026-08-02 11:00 across 8 tools

Disambiguation4/5

The tools are mostly distinct: list_calendars vs get_calendar_info for calendar list/detail, and list_events vs search_events for broad vs specific retrieval. The only slight overlap is between list_events and search_events, but their descriptions clarify the difference (range vs criteria).

Naming Consistency5/5

All tools follow a consistent verb_noun pattern using verbs like list, get, search, create, update, delete. The pattern is uniform across calendar and event resources, making the tool API predictable and easy to navigate.

Tool Count5/5

Eight tools is well-scoped for a calendar server covering two resources (calendars and events). It provides a focused set without unnecessary bulk, and each tool serves a clear purpose.

Completeness5/5

Events have full CRUD coverage (create, read, list, search, update, delete), and calendars have read operations appropriate for loaded calendars. The surface covers the expected workflows without obvious gaps for the stated purpose.

Maintenance

ActivityInactive

ResponsivenessOutdated data

Resources

Related MCP Connectors

ChronaryA
ai.chronary
Calendar API for AI agents: events, availability, Google/Microsoft setup, scheduling, and iCal.
Calendar Management Workplace & Productivity
652
https://api.chronary.ai/mcp
Smart Calendars AIA
ai.smartcalendars
Create and update subscription calendars from ChatGPT, Claude, or Codex.
Calendar Management App Automation Workplace & Productivity
71
https://api.smartcalendars.ai/mcp
Calensync
live.calensync
Manage Google, Outlook & Apple calendars and create private sync rules from chat.
Calendar Management App Automation Workplace & Productivity
1
https://api.calensync.live/mcp
calendar-bridge
io.github.IsaiahDupree
Connects ChatGPT to your Apple Calendar via a local Mac agent + Vercel relay
Calendar Management App Automation
1
https://calendarbridge.vercel.app/mcp

Related MCP Servers

Google Calendar MCP Server
SamRind
F
license
Not graded
quality
D
maintenance
Enables AI assistants to manage Google Calendar by listing, creating, updating, and deleting events. It also includes functionality to find available time slots for scheduling.
Updated 8 months ago (2026-03-05 01:03 UTC)
-
Google Calendar MCP Server
Calendar Management Workplace & Productivity
cabrac3g0
A
license
Not graded
quality
Not graded
maintenance
Enables AI assistants to read, create, update, delete, and search Google Calendar events across multiple accounts, check availability, and handle recurring events and invitations through natural language.
Updated 2 months ago (2026-09-06 02:35 UTC)
84 npm
MIT
caldav-mcp
Calendar Management Project Management
andrei06732
A
license
Not graded
quality
A
maintenance
Enables AI assistants to connect to CalDAV servers and manage calendars through natural language, including listing calendars and browsing, creating, updating, and deleting events and tasks (VTODOs). Supports recurring events, all-day events, due-date filtering, status changes, and pagination of long task lists.
Updated a month ago (2026-10-17 09:36 UTC)
732 npm
MIT
caldav-mcp
Calendar Management Project Management
Mirza699
A
license
Not graded
quality
A
maintenance
Enables AI assistants to connect to calendar servers and manage events and tasks, including listing calendars, querying timeframes, creating, updating, completing, and deleting items through tools.
Updated a month ago (2026-10-17 10:32 UTC)
732 npm
MIT

iCal MCP Server

Features

Installation

Using npx (recommended)

Global Installation

Local Development

Configuration

Environment Variables

VS Code MCP Configuration

Claude Desktop Configuration

Available Tools

Calendar Management

Event Operations

Tool Examples

List Calendars

Search Events

Create Event

Create Recurring Event

Update Event

Development

Running Tests

Building

Project Structure

License

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Google Calendar MCP Server

Google Calendar MCP Server

caldav-mcp

caldav-mcp