Skip to content

7loud/personal-mcp

Repository files navigation

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

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

About

Personal MCP server for iCloud

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors