MCP Calendar Tools

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:

   npm install
   

2. Build the Project:

   npm run build
   

3. Configure MCP:Add this server to your Claude Desktop or Antigravity MCP configuration file:

   {
     "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".