RealEvents MCP Server

Create and manage events on RealEvents from Claude, ChatGPT, Cursor, or any MCP-compatible AI assistant. Just say "create a meetup for Friday at 7pm" and your AI handles the rest. No signup required.

What is MCP?

The Model Context Protocol (MCP) is an open standard from Anthropic that lets AI assistants connect to external tools and services. RealEvents publishes an MCP server on npm so any MCP-compatible client can create, list, update, and manage events through natural language prompts.

Install in 30 seconds

Add this to your Claude Desktop config at ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Restart Claude Desktop. Then ask: "Create an event called Team Lunch for tomorrow at noon."

Other AI clients

For Cursor, edit ~/.cursor/mcp.json with the same snippet:

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

For VS Code with the GitHub Copilot or Continue extensions, see their respective MCP documentation. The package id is always realevents-mcp.

What you can do

Tool	What it does
`create_event`	Create a new event page with a title and start date. Returns a public link and a private manage link.
`get_event`	Get the public details of an event by slug.
`list_public_events`	Browse upcoming public events. Filter by format, date range, or search term.
`register_for_event`	Register an attendee for a public event.
`get_manage_event`	View an event's full details and registrations. Requires the manage token.
`update_event`	Update event details (title, date, location, status). Requires the manage token.

Example prompts

"Create a birthday party for Sarah on Friday at 7pm at Cafe Central."
"Show me upcoming events on RealEvents."
"Register john@example.com for the meetup."
"Change the location of my event to the new venue."
"How many people signed up?"

Manage token

When you create an event, the MCP server returns a manage_token. Save it - it's the only way to edit the event later. To set a default token so you don't have to paste it on every prompt, add an env block to your MCP config:

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

FAQ

Is it free?

Yes. RealEvents is free, no account required, MIT-licensed.

What data does the MCP server send?

Only the prompts you give it, forwarded to the public realevents.co API. No telemetry, no analytics inside the MCP server itself.

Will my events be visible in the public directory?

Only events with listed=true appear in list_public_events. By default, new events are unlisted: you can find them by direct slug but they don't show up in the directory. Use update_event to change the listed flag.