Mcp Ical
A Model Context Protocol Server that allows you to interact with your MacOS Calendar through natural language.
What is Mcp Ical?
Mcp Ical is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that allows you to interact with your macos calendar through natural language.
A Model Context Protocol Server that allows you to interact with your MacOS Calendar through natural language.
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol Server that allows you to interact
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-icalConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Mcp Ical
MCP iCal is a Python-based MCP server that connects Claude (and other MCP clients) directly to the macOS Calendar app, enabling natural-language management of your calendar events. Through this server you can query upcoming schedules, create events with locations and reminders, reschedule meetings, check availability windows, and manage recurring events — all without leaving your AI chat interface. It works with any calendar synced to the macOS Calendar app, including Google Calendar and iCloud.
Prerequisites
- macOS with the Calendar app configured and at least one calendar added
- Python 3.12 or higher
- uv package manager installed (https://github.com/astral-sh/uv)
- Claude for Desktop (recommended) or another MCP-compatible client
- macOS calendar permission granted to the terminal/Claude app
Clone the repository
Clone the mcp-ical repository from GitHub and change into the project directory.
git clone https://github.com/Omar-V2/mcp-ical.git
cd mcp-icalInstall dependencies with uv
Use uv to create a virtual environment and install all required Python packages as defined in the project's lockfile.
uv syncConfigure Claude for Desktop
Open (or create) the Claude Desktop configuration file and add the mcp-ical server entry. Replace the directory path with the absolute path to where you cloned the repository.
# Edit: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"mcp-ical": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/mcp-ical",
"run",
"mcp-ical"
]
}
}
}Launch Claude from the terminal
On the first run, macOS must prompt you to grant calendar access. This only happens when Claude is launched from a terminal session. Open Claude this way once to approve the permission.
/Applications/Claude.app/Contents/MacOS/ClaudeGrant calendar permissions
When the macOS calendar permission dialog appears, click 'Allow'. This grants Claude access to read and write calendar data through the mcp-ical server. Future launches of Claude from the app icon will retain this permission.
Mcp Ical Examples
Client configuration
Full claude_desktop_config.json entry for mcp-ical using uv to run the server from the cloned directory.
{
"mcpServers": {
"mcp-ical": {
"command": "uv",
"args": [
"--directory",
"/Users/yourname/projects/mcp-ical",
"run",
"mcp-ical"
]
}
}
}Prompts to try
Use these natural-language prompts in Claude after configuring mcp-ical to manage your macOS Calendar.
- "What's my schedule for next week?"
- "Add a lunch meeting with Sarah tomorrow at noon at Cafe Blue"
- "When am I free for a 2-hour meeting next Tuesday?"
- "Move tomorrow's team standup to 3 PM"
- "Create a recurring weekly review every Friday at 4 PM"
- "Show me all events with the word 'dentist' this year"Troubleshooting Mcp Ical
Claude cannot access the calendar and shows a permission error
You must launch Claude from the terminal at least once using '/Applications/Claude.app/Contents/MacOS/Claude' so macOS shows the calendar permission dialog. If you already denied permission, go to System Settings > Privacy & Security > Calendars and enable access for Claude.
uv sync fails with a Python version error
The server requires Python 3.12+. Run 'uv python install 3.12' to install the required version, then re-run 'uv sync'. Alternatively install Python 3.12 from python.org and ensure it is on your PATH.
Events are created but do not appear in Google Calendar
Events are written to whichever calendar is set as the default in the macOS Calendar app. Open Calendar > Preferences > General and verify the 'Default Calendar' is your Google Calendar account. You can also tell Claude to add the event to a specific calendar by name.
Frequently Asked Questions about Mcp Ical
What is Mcp Ical?
Mcp Ical is a Model Context Protocol (MCP) server that model context protocol server that allows you to interact with your macos calendar through natural language. 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. 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.