# mcp-ical

> 5 ICS / iCalendar tools for Claude. Generate, parse, and one-click-add events to Google/Outlook. Free, MIT.

Pure-logic calendar utilities. **No API keys, no accounts, no SaaS coupling.** Generates standards-compliant RFC 5545 ICS files.

---

## Install

```json
{
  "mcpServers": {
    "ical": {
      "command": "npx",
      "args": ["-y", "@dpm-tools/mcp-ical"]
    }
  }
}
```

Requires Node.js 22.18+.

---

## Tools (5)

- **`create_event`** — Generate ICS for a single event (title, start, end, location, description, organizer, attendees, all-day).
- **`create_calendar`** — Build a multi-event ICS file.
- **`parse_ics`** — Parse existing ICS content into event objects.
- **`google_calendar_url`** — One-click "Add to Google Calendar" URL (no auth).
- **`outlook_calendar_url`** — One-click "Add to Outlook Web Calendar" URL.

---

## Example prompts

- *"Make an ICS file for a meeting tomorrow 2pm-3pm titled 'Sprint planning' at Zoom URL ..."*
- *"Build a calendar from these 5 events..."*
- *"Parse this ICS file and tell me when the next event is."*
- *"Give me a Google Calendar 'Add' link for the team offsite on 2026-07-15."*

See [`examples/prompts.md`](./examples/prompts.md) for more.

---

## Why this exists

Existing calendar MCPs assume a SaaS backend (Google Calendar OAuth, Microsoft Graph). For LLMs that just need to **emit a standards-compliant ICS file** or **build an add-to-calendar link**, those are overkill.

`mcp-ical` is the **pure-logic version**:
- Zero dependencies beyond `@modelcontextprotocol/sdk`
- Zero API keys
- Zero accounts
- RFC 5545 line folding, escape sequences, attendee/organizer support

Perfect for "tell me about an event then make an ICS attachment" workflows.

---

## Sister servers from dpm

- **`mcp-devkit`**, **`mcp-public-data`**, **`mcp-diff`**, **`mcp-archive`**, **`mcp-citations`** — all free, all MIT.

---

## License

MIT © dpm (digital product mill)