mcp-ical MCP Server

What does “mcp-ical” MCP Server do?

The mcp-ical MCP Server acts as a bridge between AI assistants and your macOS Calendar, enabling seamless, natural language interactions for calendar management. By leveraging the Model Context Protocol (MCP), mcp-ical allows users to query their schedule, create events, update appointments, and manage calendars using conversational prompts. This greatly enhances productivity by turning otherwise manual calendar actions into intuitive, AI-powered workflows. With features like smart reminders, recurring events, and support for custom calendars (including Google Calendar integration via iCloud), mcp-ical streamlines scheduling, availability checks, and event updates, making it an invaluable tool for developers and users who want to integrate calendar management directly into their AI-driven development or personal workflows.

List of Prompts

No explicit prompt templates are listed in the repository documentation or code.

List of Resources

No explicit MCP resources are described in the documentation or available files.

List of Tools

• Event Creation: Instantly create calendar events from natural language input.
• Smart Schedule Query: Retrieve upcoming events and check availability based on user queries.
• Event Update: Modify existing events, including time, date, calendar, location, notes, reminders, and recurrence.
• Calendar Listing: View all available calendars and receive smart suggestions.

Use Cases of this MCP Server

• Natural Language Calendar Management: Users can ask AI assistants simple questions like “What’s on my calendar next week?” and receive an organized summary, eliminating the need to manually browse through calendar apps.
• Automated Event Creation: Developers can integrate the server into workflows where events (like meetings, reminders, or deadlines) are scheduled automatically based on chat input.
• Intelligent Availability Checking: Quickly find open time slots for meetings or appointments, improving productivity and reducing back-and-forth scheduling.
• Event Modification: Effortlessly update details of existing calendar events, such as rescheduling, changing locations, or adding notes, directly from natural language requests.
• Multi-Calendar and Google Calendar Support: Manage events across multiple calendars, including Google Calendar (if synced with iCloud), from a single conversational interface.

How to set it up

Windsurf

1. Prerequisite: Ensure Node.js and Python 3.12+ are installed.
2. Locate the Windsurf configuration file (e.g., windsurf.config.json).
3. Add the mcp-ical MCP server to the mcpServers section:

   {
     "mcpServers": {
       "ical-mcp": {
         "command": "npx",
         "args": ["@mcp-ical/mcp-server@latest"]
       }
     }
   }
   

4. Save the configuration and restart Windsurf.
5. Verify the server appears in the MCP integrations.

Securing API Keys:

{
  "mcpServers": {
    "ical-mcp": {
      "command": "npx",
      "args": ["@mcp-ical/mcp-server@latest"],
      "env": {
        "ICAL_API_KEY": "${ICAL_API_KEY}"
      },
      "inputs": {
        "ICAL_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude

1. Prerequisite: Python 3.12+.
2. Open Claude’s integration config file.
3. Insert the following JSON for mcp-ical:

   {
     "mcpServers": {
       "ical-mcp": {
         "command": "npx",
         "args": ["@mcp-ical/mcp-server@latest"]
       }
     }
   }
   

4. Save and restart Claude.
5. Verify connectivity to your calendar.

Cursor

1. Prerequisite: Ensure Node.js and Python 3.12+.
2. Locate the Cursor configuration file.
3. Add mcp-ical server:

   {
     "mcpServers": {
       "ical-mcp": {
         "command": "npx",
         "args": ["@mcp-ical/mcp-server@latest"]
       }
     }
   }
   

4. Save and restart Cursor.
5. Confirm the server is running in MCP mode.

Cline

1. Prerequisite: Install Node.js and Python 3.12+.
2. Edit the Cline configuration file.
3. Add mcp-ical server entry:

   {
     "mcpServers": {
       "ical-mcp": {
         "command": "npx",
         "args": ["@mcp-ical/mcp-server@latest"]
       }
     }
   }
   

4. Save the file and restart Cline.
5. Test with a simple calendar command.

Note: Replace ICAL_API_KEY and other sensitive values with environment variables to secure credentials.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "ical-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “ical-mcp” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Supports Roots: ⛔ Not specified
Supports Sampling: ⛔ Not specified

Based on the information in the tables, the MCP-ical server is well-documented for its features and setup but lacks explicit resources and prompt templates. There is no mention of Roots or Sampling support. I would rate this MCP server a 6/10 for utility and documentation completeness.

MCP Score