# mcp-ical

> MCP Server

The mcp-ical server transforms macOS calendar management into a conversational experience using natural language and the Model Context Protocol. It allows users to create events, manage schedules, and check availability easily.

## Overview

- **Category:** Productivity
- **Language:** Python
- **Stars:** 324
- **Forks:** 10
- **Owner:** Omar-V2
- **GitHub:** https://github.com/Omar-V2/mcp-ical
- **Created:** 2025-02-09T22:17:16+00:00
- **Updated:** 2025-03-28T18:12:03+00:00
- **Source:** https://model-context-protocol.com/servers/macos-calendar-natural-language-interface

## Setup

## Setup

1. **Clone and Setup**
```bash
# Clone the repository
git clone https://github.com/yourusername/mcp-ical.git
cd mcp-ical

# Install dependencies
uv sync
```

2. **Configure Claude for Desktop**

Create or edit `~/Library/Application\ Support/Claude/claude_desktop_config.json`:

```json
{
    "mcpServers": {
        "mcp-ical": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/mcp-ical",
                "run",
                "mcp-ical"
            ]
        }
    }
}
```

3. **Launch Claude for Calendar Access**

> ⚠️ **Critical**: Claude must be launched from the terminal to properly request calendar permissions. Launching directly from Finder will not trigger the permissions prompt.

```bash
/Applications/Claude.app/Contents/MacOS/Claude
```

4. **Start Using!**
```
Try: "What's my schedule looking like for next week?"
```

> 🔑 **Note**: When you first use a calendar-related command, macOS will prompt for calendar access. This prompt will only appear if you launched Claude from the terminal as specified above.

## Tools

## Available Tools

1. Event Creation (Transform natural language into calendar events instantly!)
2. Smart Schedule Management & Availability (Quick access to your schedule with natural queries)
3. Intelligent Event Updates (Modify events naturally)
4. Calendar Management (View all available calendars and smart calendar suggestions)