# MCP Calendar Tools

This Model Context Protocol (MCP) server provides tools for reading and managing calendar events using local `.ics` (iCalendar) files. It is completely offline and does not require complex OAuth setups with Google/Apple.

## Overview

The `mcp-calendar` server exposes these tools:
1. `get_schedule`: Reads the `.ics` file and lists events for a specific date.
2. `create_event`: Creates a new event and appends it to your `.ics` file.

## Prerequisites

1. **Node.js** installed (v18 or higher recommended).
2. **Calendar File**: Place an exported calendar file named `calendar.ics` in the root of this project (or specify the path in your config). 

## Steps to Run

1. **Install Dependencies:**
   ```bash
   npm install
   ```

2. **Build the Project:**
   ```bash
   npm run build
   ```

3. **Configure MCP:**
   Add this server to your Claude Desktop or Antigravity MCP configuration file:
   ```json
   {
     "mcpServers": {
       "calendar": {
         "command": "node",
         "args": ["/absolute/path/to/mcp-calendar/build/index.js"],
         "env": {
            "CALENDAR_FILE_PATH": "/absolute/path/to/your/calendar.ics"
         }
       }
     }
   }
   ```
   *(Note: Adjust the absolute path to point to where you saved this folder. If `CALENDAR_FILE_PATH` is omitted, it defaults to `./calendar.ics` in the project root).*

4. **Restart your MCP Client.** You can now ask the AI to "Check my schedule for tomorrow" or "Add a meeting at 3 PM".