MCP iCal
Transforms macOS calendar management into a conversational experience using natural language, allowing users to create, manage, and update calendar events seamlessly through an MCP-compatible client.
What is MCP iCal?
MCP iCal is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to transforms macos calendar management into a conversational experience using natural language, allowing users to create, manage, and update calendar events seamlessly through an mcp-compatible client.
Transforms macOS calendar management into a conversational experience using natural language, allowing users to create, manage, and update calendar events seamlessly through an MCP-compatible client.
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Transforms macOS calendar management into a conversational e
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-ical-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCP iCal
MCP iCal Server transforms macOS calendar management into a fully conversational experience by connecting MCP-compatible AI clients to the native macOS Calendar app. Built on the same Omar-V2/mcp-ical foundation, it lets you create, query, modify, and delete calendar events using plain English, supporting multi-calendar setups including Google Calendar and iCloud synced through macOS. The server is especially useful for scheduling assistants, daily planning workflows, and automating repetitive calendar tasks through natural language commands.
Prerequisites
- macOS with the Calendar app configured and at least one calendar added
- Python 3.12 or higher
- uv package manager (https://github.com/astral-sh/uv)
- Claude for Desktop or another MCP-compatible client
- macOS calendar permission granted to the terminal/Claude process
Clone the repository
Clone the mcp-ical repository (which powers mcp-ical-server) and enter the project directory.
git clone https://github.com/Omar-V2/mcp-ical.git
cd mcp-icalInstall dependencies
Use uv to install all Python dependencies into an isolated virtual environment.
uv syncAdd the server to your MCP client configuration
Edit your Claude Desktop config file to register the mcp-ical server. Replace the directory path with the absolute path where you cloned the repo.
# ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"mcp-ical-server": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/mcp-ical",
"run",
"mcp-ical"
]
}
}
}Launch Claude from terminal to trigger permissions
macOS requires an interactive terminal session to display the calendar permission prompt. Launch Claude this way on the first run so you can approve access.
/Applications/Claude.app/Contents/MacOS/ClaudeApprove calendar access and verify
Click Allow on the macOS calendar permission dialog. Once granted, you can restart Claude normally and the server will have persistent access to your calendars.
MCP iCal Examples
Client configuration
Complete claude_desktop_config.json entry to register the mcp-ical-server with Claude for Desktop.
{
"mcpServers": {
"mcp-ical-server": {
"command": "uv",
"args": [
"--directory",
"/Users/yourname/projects/mcp-ical",
"run",
"mcp-ical"
]
}
}
}Prompts to try
Natural language commands you can send to your AI client once the server is configured.
- "What meetings do I have tomorrow?"
- "Schedule a 1-on-1 with Alex next Monday at 10 AM for 30 minutes"
- "Find a free 1-hour slot for a call sometime this week"
- "Cancel my 3 PM meeting on Thursday"
- "Add a reminder to submit my expense report on Friday at 9 AM"
- "List all events in my Work calendar for this month"Troubleshooting MCP iCal
Permission denied error when accessing Calendar
Launch Claude from the terminal ('/Applications/Claude.app/Contents/MacOS/Claude') at least once. If you previously denied permission, open System Settings > Privacy & Security > Calendars and enable Claude.
Server fails to start with 'Python not found' error
Ensure Python 3.12+ is installed. Run 'uv python install 3.12' to let uv manage the Python version, then re-run 'uv sync' to reinstall dependencies against the correct runtime.
Events are created on the wrong calendar
Open the macOS Calendar app, go to Preferences > General, and set the Default Calendar to the one you want. You can also specify the target calendar explicitly in your prompt, e.g. 'Add this to my Personal calendar'.
Frequently Asked Questions about MCP iCal
What is MCP iCal?
MCP iCal is a Model Context Protocol (MCP) server that transforms macos calendar management into a conversational experience using natural language, allowing users to create, manage, and update calendar events seamlessly through an mcp-compatible client. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCP iCal?
Follow the installation instructions on the MCP iCal GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCP iCal?
MCP iCal works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCP iCal free to use?
Yes, MCP iCal is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
MCP iCal Alternatives — Similar Communication Servers
Looking for alternatives to MCP iCal? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCP iCal in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCP iCal?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.