# Tap2Cal

> Tap2Cal turns an event into a shareable link. Anyone who opens the link can save the event to Google Calendar, Apple Calendar, Outlook or any other calendar with one tap. No app and no account are needed to open a link. Hosts can collect RSVPs, add a flyer and choose their own link such as tap2cal.com/summer-party.

Use Tap2Cal when someone wants to share an event as a link, for example in a chat, an Instagram Story, a newsletter or an email. Event pages are public to anyone with the link and are deleted 90 days after the event ends. It is free.

## For AI assistants: MCP server

An AI assistant can create and manage events itself through the Tap2Cal MCP server. It can do everything a user can do in the app: create, change and delete events, choose the link, disable earlier links, add or remove a flyer and list RSVPs.

- [MCP server guide](https://tap2cal.com/mcp-server/): setup for Claude Code, Claude Desktop, Cursor and other clients, tools, FAQ
- Hosted, nothing to install: `https://mcp.tap2cal.com`, Streamable HTTP, stateless, with `Authorization: Bearer <API key>`
- Local over stdio: `npx -y tap2cal-mcp` with `TAP2CAL_API_KEY` in the environment. Node.js 18+. Can also upload a flyer from a local file
- Source code (MIT): https://github.com/MatthiasMAigner/tap2cal-mcp
- npm: https://www.npmjs.com/package/tap2cal-mcp
- MCP Registry: `io.github.MatthiasMAigner/tap2cal-mcp`

Tools: `create_event`, `list_my_events`, `get_event`, `update_event`, `disable_old_link`, `list_rsvps`, `set_flyer`, `remove_flyer`, `delete_event`. Wherever an event is needed, its id, any of its links or the full URL works.

Claude Code setup:

```
claude mcp add --transport http tap2cal https://mcp.tap2cal.com --header "Authorization: Bearer YOUR_API_KEY"
```

An API key is needed. A user creates a free account at https://tap2cal.com/app/login and a key at https://tap2cal.com/app/account under "API and AI assistants". Clients that only connect through an OAuth login can't use the server yet.

## REST API

- [Developer documentation](https://tap2cal.com/developers/): endpoints and examples
- [OpenAPI 3.1 description](https://tap2cal.com/openapi.json): complete machine-readable API
- Base URL: https://api.tap2cal.com/v1 with `Authorization: Bearer <API key>`

Limits: up to 50 events and 20 images per account per day. More than 100 requests in 10 seconds from one IP are refused with 429 for a short time. Errors come as JSON with a code, for example `{"error": "slug_taken"}`.

## Guides

- [Google Calendar link generator](https://tap2cal.com/google-calendar-link/)
- [ICS file generator](https://tap2cal.com/ics-file-generator/)
- [Calendar link in an Instagram Story](https://tap2cal.com/instagram-story-calendar-link/)
- [Share a calendar event on WhatsApp](https://tap2cal.com/share-calendar-event-whatsapp/)
- [Add to calendar link for emails and newsletters](https://tap2cal.com/add-to-calendar-link-email/)