MCP HubMCP Hub
Omar-V2

mcp-ical

by: Omar-V2

A Model Context Protocol Server that allows you to interact with your MacOS Calendar through natural language.

61created 09/02/2025
Visit
MacOS
Calendar

📌Overview

Purpose: To enhance macOS calendar management by enabling users to create and manage events using natural language through the MCP iCal Server.

Overview: The MCP iCal Server allows users to interact with their macOS calendar seamlessly using conversational commands. By leveraging the Model Context Protocol, it transforms the scheduling experience into a more intuitive and engaging format.

Key Features:

  • Event Creation: Quickly converts natural language requests into calendar events, enabling efficient scheduling with smart reminders, location entries, and multiple calendar support.

  • Smart Schedule Management & Availability: Provides instant access to upcoming events and identifies available time slots for meetings based on natural language queries.

  • Intelligent Event Updates: Allows users to modify existing events naturally, including changes to time, location, and reminders, ensuring effortless updates to their schedules.

MCP iCal Server

🗓️ Natural Language Calendar Management for macOS

🌟 Overview

Transform how you interact with your macOS calendar using natural language! The mcp-ical server leverages the Model Context Protocol (MCP) for a conversational calendar management experience.

✨ Features

📅 Event Creation

Transform natural language into calendar events instantly!

Supported Features:

  • Custom calendar selection
  • Location and notes
  • Smart reminders
  • Recurring events

🔍 Smart Schedule Management & Availability

Quick access to your schedule with natural queries.

✏️ Intelligent Event Updates

Modify events naturally with capabilities to change time, location, notes, and reminders.

📊 Calendar Management

  • View all available calendars
  • Smart calendar suggestions

🚀 Quick Start

Prerequisites

Installation

  1. Clone and Setup

    git clone https://github.com/yourusername/mcp-ical.git
cd mcp-ical

uv sync

  2. Configure Claude for Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json with the following: json { "mcpServers": { "mcp-ical": { "command": "uv", "args": [ "--directory", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-ical", "run", "mcp-ical" ] } } }

  1. Launch Claude for Calendar Access

Launch Claude from the terminal to request calendar permissions: bash /Applications/Claude.app/Contents/MacOS/Claude

  1. Start Using! 
    Try: "What's my schedule looking like for next week?"

🧪 Testing

uv sync --dev
uv run pytest tests

🐛 Known Issues

  • Non-standard recurring schedules may not always be set correctly.
  • Results may vary based on the version of Claude.

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch
  3. Commit your changes
  4. Push to the branch
  5. Open a Pull Request

📝 License

This project is licensed under the MIT License.

🙏 Acknowledgments