MCP iCal Server

@Omar-V2

Repository

Basic information

About MCP iCal Server

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

#icalendar#mcp #llm #model-context-protocol #mcp-server

MCP iCal Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-ical": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

MCP iCal Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP iCal Server?

MCP iCal Server is an MCP (Model Context Protocol) server that enables natural language calendar management for macOS. It converts spoken or typed requests into calendar actions, letting users create, query, update, and manage events with conversational prompts.

How to use MCP iCal Server?

Install prerequisites: uv package manager and an MCP client like Claude for Desktop. Clone the repository, run uv sync, then add the server configuration to claude_desktop_config.json with the command uv --directory /path/to/mcp-ical run mcp-ical. Launch Claude from the terminal (not Finder) to allow calendar permissions, then type natural‑language requests such as “What’s my schedule for next week?”.

Key features of MCP iCal Server

Natural‑language event creation with location, notes, and reminders
Schedule queries and availability detection
Intelligent event updates (time, date, calendar, location)
Support for recurring events and multi‑calendar management
Google Calendar integration when synced with iCloud
Seamless macOS Calendar permission handling

Use cases of MCP iCal Server

Schedule a team lunch or recurring weekly sync using plain English
Find free time slots for a meeting on a specific day
Move, reschedule, or cancel events without manual data entry
Add detailed notes and reminders to events across multiple calendars
Query your upcoming schedule for any date range

Frequently asked questions

What prerequisites are needed?

macOS with the built‑in Calendar app, the `uv` package manager, and an MCP‑compatible client (Claude for Desktop is recommended).

How do I grant calendar access?

Calendar permissions must be granted by launching Claude from the terminal (`/Applications/Claude.app/Contents/MacOS/Claude`). Launching from Finder will not trigger the permission prompt. Manual access can be configured but involves system‑file modifications.

Can I use this server with Google Calendar?

Yes. If your Google Calendar is synced with iCloud Calendar, you can create events in that Google Calendar by specifying the calendar name when issuing a command.

Are there any known issues?

Recurring events with non‑standard schedules may not always be set correctly. Results are better with Claude 3.5 Sonnet than with Haiku. Reminder timing for recurring all‑day events may be off by one day.

How can I test the server?

Install dev dependencies with `uv sync --dev` and run `uv run pytest tests`. Test suites create temporary calendars and events, which are cleaned up automatically. Only run tests in development environments.

Comments

More Other MCP servers

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

ICSS

chokcoco

不止于 CSS

20.7K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K