Tap2Cal

Calendar MCP server for AI assistants

Let Claude, Cursor or any MCP client turn an event into a shareable add-to-calendar link. Guests open the link and save the event to Google Calendar, Apple Calendar, Outlook or any other calendar with one tap. No app and no account needed on their side.

What you can ask

Make a calendar link for our summer party on July 5, 6 to 10 pm in Vienna, with RSVPs, at tap2cal.com/summer-party.

Move the summer party to July 12 and add the poster on my desktop as flyer.

Who has accepted so far, and how many people are coming in total?

The assistant can do everything you can do in the app: create, change and delete events, choose the link, disable earlier links, add a flyer and read who accepted or declined.

1. Get an API key

Create a free account, open your account and create a key under “API and AI assistants”. Events created with it appear under My events.

2a. Connect the hosted server

Nothing to install. The server is at https://mcp.tap2cal.com and uses Streamable HTTP with your key in the Authorization header. In Claude Code:

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

Cursor, Windsurf, VS Code and most other clients take a configuration like this:

{
  "mcpServers": {
    "tap2cal": {
      "type": "http",
      "url": "https://mcp.tap2cal.com",
      "headers": {"Authorization": "Bearer YOUR_API_KEY"}
    }
  }
}

2b. Or run it locally with npx

The open source package tap2cal-mcp runs over stdio and needs Node.js 18 or newer. It can also upload a flyer from a file on your computer.

claude mcp add tap2cal -e TAP2CAL_API_KEY=YOUR_API_KEY -- npx -y tap2cal-mcp

For Claude Desktop, add this to claude_desktop_config.json:

{
  "mcpServers": {
    "tap2cal": {
      "command": "npx",
      "args": ["-y", "tap2cal-mcp"],
      "env": {"TAP2CAL_API_KEY": "YOUR_API_KEY"}
    }
  }
}

Tools

Wherever an event is needed, its id, any of its links or the full URL works.

ToolWhat it does
create_eventCreates an event and returns its link, optionally with your own link via slug
list_my_eventsLists your events with page views, calendar clicks and RSVP counts
get_eventShows one event with all details and its earlier links
update_eventChanges only the fields you name, including the link
disable_old_linkTurns off an earlier link after the link was changed
list_rsvpsLists who accepted or declined, with the people they bring
set_flyerAdds a flyer from an image URL, as base64, or locally from a file
remove_flyerRemoves the flyer
delete_eventDeletes an event and all its links, marked as destructive

Questions

What does the Tap2Cal MCP server do?

It lets an AI assistant turn an event into a shareable add-to-calendar link. Anyone who opens the link saves the event to Google Calendar, Apple Calendar, Outlook or any other calendar with one tap. The assistant can also change events, choose the link, add a flyer and read RSVPs.

Which AI assistants can use it?

Any MCP client that can send a header or run a local command, for example Claude Code, Claude Desktop, Cursor, Windsurf, Zed, VS Code and Cline. Clients that only connect through an OAuth login can't use it yet.

Do I need an account?

Yes, a free Tap2Cal account. Create an API key in your account and give it to the assistant. Guests who open the links need no account and no app.

Is it free?

Yes. Each account can create up to 50 events and upload 20 images per day.

Hosted or local, which one should I use?

The hosted server at https://mcp.tap2cal.com needs nothing installed. The local package tap2cal-mcp runs with npx and can additionally upload a flyer from a file on your computer. Both offer the same tools.

Who can see the events?

Event pages are public to anyone with the link, like a shared invitation. They are deleted 90 days after the event ends.

Links