Advertise
MCP.so
Sign In

MCP iCal Server

@Omar-V2

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

Omar-V2

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

1

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).

2

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.

3

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.

4

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.

5

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

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

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

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

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

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K
Advertise