MCP iCal Server

@Omar-V2

代码仓库

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

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

MCP iCal Server 配置

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

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

MCP iCal Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 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

常见问题

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 服务器

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.