MCP iCal Server

Name: MCP iCal Server
Author: Omar-V2

@Omar-V2

代码仓库

关于 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

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

Omar-V2

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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

FAQ from MCP iCal Server

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.

其他分类下的更多 MCP 服务器

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K