Personal MCP Server

A personal Model Context Protocol (MCP) server that provides calendar integration with iCloud through CalDAV protocol. This server allows seamless interaction with iCloud calendars through a standardized API.

Features

• Calendar management through iCloud CalDAV

• Support for listing, creating, updating, and deleting calendar events

• Calendar listing and management

• Secure authentication and request validation

• Health check endpoint

Related MCP server: iCloud Calendar MCP

Available Tools

Calendar Tools

• list_icloud-calendars: List all available iCloud calendars

• icloud-calendar_list_events: Retrieve events within a specified time range

• icloud-calendar_create_event: Create new calendar events

• icloud-calendar_update_event: Update existing calendar events

• icloud-calendar_delete_event: Delete calendar events

Contacts Tools

Currently under development.

Configuration

The server can be configured using environment variables. Take a look at .env.example for a list of available variables. Feel free to copy the file and rename it to .env.

Usage

1. Set up your environment variables

2. Start the server using npm start

3. Access the server at http://localhost:<PORT>

Endpoints

• /: Server information

• /health: Health check

• /shttp: Main MCP communication endpoint