io.github.ykastelnik/realevents

RealEvents MCP Server

Create and manage events on RealEvents from any MCP-compatible AI assistant.

Documentation and install snippets: https://realevents.co/mcp

Install

{
  "mcpServers": {
    "realevents": {
      "command": "npx",
      "args": ["-y", "realevents-mcp"]
    }
  }
}

For Claude Desktop on macOS, the config file is at ~/Library/Application Support/Claude/claude_desktop_config.json. For other clients, see their MCP documentation.

Agent skill

skills/realevents/SKILL.md teaches an assistant when and how to use these tools: creating an event with the right timezone, handing back the manage link, and the head-count and guest-list rules below. Copy the skills/realevents folder into your client's skills directory (for Claude Code, ~/.claude/skills/) alongside the server config above.

Tools

Public, no token needed:

Organizer tools, all requiring the manage token:

Comments only work on events where the organizer has switched them on (update_event with allow_comments: true). Until then both comment tools return a message saying exactly that.

Cover images

set_cover takes a public image URL, not a file. MCP tool arguments are JSON text, so an assistant cannot hand a local image to the server; if the picture is on the user's computer, the manage page's upload does the job better anyway (drag and drop, preview, crop). Around 1200px wide or more looks best - set_cover says so when the image is smaller rather than silently accepting a thumbnail.

Timezones

create_event takes a timezone (an IANA name such as Europe/Paris) alongside start_datetime. Set it. The start time is interpreted in that zone, and the zone defaults to UTC, so creating an event for 19:00 without one produces a page that reads 19:00 UTC: the wrong hour for everyone outside it.

Prefer a local time with no trailing Z:

start_datetime: "2026-06-15T19:00:00"
timezone:       "Europe/Paris"

Attendance is counted in people

An event's attendance figure is a head-count: confirmed guests plus everyone they bring. A guest arriving with three others takes four of the available places, so a party can be refused on an event that still shows free rows. When that happens the error states how many places are left, so the call can be retried with a smaller party rather than reported as a failure.

Plus-ones only attach to a confirmed answer, and are capped by the event's own plus_ones_limit (0 disables them). When the organizer collects names rather than a headcount, every declared guest needs one. get_event reports both settings.

Manage token

Events created with create_event return a manage_token. Save it: it is the only way to manage the event later.

To set a default token so you don't have to pass it on every call:

{
  "mcpServers": {
    "realevents": {
      "command": "npx",
      "args": ["-y", "realevents-mcp"],
      "env": {
        "REALEVENTS_MANAGE_TOKEN": "your-token"
      }
    }
  }
}

Security

Signed with npm Provenance, built from this repository via GitHub Actions. Every published version is traceable back to the exact commit and workflow run that built it.

Links

• realevents.co
• Documentation
• GitHub repository
• MCP Registry listing

For maintainers: publishing checklist

Before publishing a new version:

1. Bump version in package.json
2. Verify mcpName: "io.github.ykastelnik/realevents" is still present
3. Bump version and packages[0].version in server.json to match
4. Tag vX.Y.Z and push: the publish.yml workflow handles the npm publish
5. Locally: ./mcp-publisher publish to sync the MCP Registry listing

License

MIT