# Luma MCP > Luma MCP Server connects your AI client directly to event registration data. It lets you create new events, manage guest lists, track attendance, and view organizational calendars using natural conversation. You can list all managed events or check specific guest rosters without leaving your chat. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** event-registration, community-engagement, attendee-management, calendar-scheduling, virtual-events ## Description You connect your AI client directly to Luma. It lets you run event management straight from your chat interface; you don't need to jump between apps or copy/paste anything. This setup gives your agent full access to core event data, so you can manage guest lists and build new events using nothing but natural conversation. **Tracking Your Schedule & Organization Overview** Need to know what’s going on? You've got tools for both personal tracking and organization-wide oversight. If you just wanna see the events *you* personally managed, call `list_events`. It spits out a list of all those specific events linked to your account. But if you need the full picture—every single event that exists within the entire Luma organizational account, no matter who set it up—use `list_organization_events`. You'll get a complete rundown of everything happening in the organization. For calendar details, you can check out who’s subscribed to your personal feed by running `list_calendar_subscribers`. It shows you exactly which people are getting updates from your Luma calendar. If you need specific event schedule info, you can list all managed events or check general details about the organization's broader calendar. **Handling Guest Lists and Attendees** Managing who’s coming is where this thing really shines. To see the full roster for a single, specific event, just run `list_event_guests`. That tool pulls the entire list of attendees for that one show. If you gotta update those numbers, don't sweat it; you can manually add people to an existing guest list by using `add_guests_to_event`, and you just specify who needs to be added and which event they belong to. You keep your guest records accurate without ever having to leave your chat. **Creating Events on the Fly** Don't have a new thing planned? No big deal. You can generate and publish an entirely brand-new Luma event directly through conversation using `create_event`. It sets up all the necessary details and gets it published, all from your agent. This means you never gotta wait for someone else to build out the initial scaffolding for an event. This setup makes sure that whether you're tracking team activity across the whole company or just adding one person to a dinner party list, everything stays right here in the chat. You don’t have to switch screens; your AI client handles it all. ## Tools ### add_guests_to_event Adds specified people directly to an existing Luma event's guest list. ### create_event Sets up and publishes a completely new Luma event for the organization. ### list_event_guests Retrieves and displays the full roster of attendees for a single, specified event. ### list_events Displays a list of all events personally managed by you on Luma. ### list_organization_events Retrieves a complete list of every event within the entire organizational account. ### list_calendar_subscribers Shows who is subscribed to your personal calendar feed within Luma. ## Prompt Examples **Prompt:** ``` List all my upcoming events in Luma. ``` **Response:** ``` I've retrieved your events. You have 3 upcoming activities including 'AI Workshop' and 'Community Meetup'. Which one would you like to see guest counts for? ``` **Prompt:** ``` Show me the guest list for the 'Product Launch' event. ``` **Response:** ``` I've retrieved the guest list. There are 45 confirmed attendees, including 10 VIPs. Would you like me to highlight any specific group? ``` **Prompt:** ``` Add 'sarah@example.com' to the workshop guest list. ``` **Response:** ``` Sarah has been successfully added to the 'AI Workshop' guest list. Would you like me to send her the calendar invitation now? ``` ## Capabilities ### Track event schedules List all managed Luma events or check specific details about your organization's calendar. ### Check guest attendance Pull the full list of attendees for a specified event using `list_event_guests`. ### Add new registrants Manually add specific individuals to an existing event's guest list via the `add_guests_to_event` tool. ### Create events from chat Generate and set up a brand new Luma event directly through conversation using `create_event`. ### Monitor org-wide activity List all events belonging to the entire organization, regardless of who created them (`list_organization_events`). ## Use Cases ### Need a quick headcount before a meeting? The Product Manager needs to know how many people are coming to the 'Q3 Workshop.' Instead of logging into Luma, they ask their agent: 'Show me the guest list for the Q3 Workshop.' The agent runs `list_event_guests` and replies with 45 confirmed attendees. Problem solved in seconds. ### Running a new initiative? The Department Head needs a brand-new training session scheduled next month. They prompt their AI: 'Create an event called 'Compliance Training' for the 15th.' The agent uses `create_event`, sets up all necessary details, and publishes it immediately. ### Checking organizational compliance? The Ops Lead needs to audit every event running this quarter. Instead of clicking through multiple folders, they ask their AI: 'What are all the organization events?' The agent runs `list_organization_events`, giving them a single view of everything. ### A last-minute invitee? Someone forgot to manually add an executive who just joined. Instead of email pinging, they ask their AI: 'Add John Smith at john@corp.com to the Annual Gala.' The agent executes `add_guests_to_event`, updating the list instantly. ## Benefits - Stop switching apps to check attendance. Use `list_event_guests` and get the full attendee list in one query, keeping you focused on the conversation. - Build events instantly. Calling `create_event` means you don't have to navigate the Luma dashboard; just tell your AI agent what it needs to set up. - Keep track of everyone involved. The `list_organization_events` tool lets you see every event the company is running, making sure no one misses a deadline. - Never lose a guest. If someone RSVPs last minute, use `add_guests_to_event` to manually add them without needing access to the web UI. - Stay organized by viewing all your personal events with `list_events`. It keeps your individual schedule clear while maintaining system visibility. ## How It Works The bottom line is, your AI acts like a dedicated event coordinator, handling Luma tasks through chat instead of requiring manual dashboard logins. 1. Subscribe to this server and provide your Luma API Key (requires Luma Plus) in the settings. 2. Start a conversation with your AI client, asking for specific event data or tasks (e.g., 'List all my upcoming events'). 3. Your agent calls the appropriate tool (`list_events`, `add_guests_to_event`) and delivers the requested information back to you in plain text. ## Frequently Asked Questions **How do I see all events run by my company using list_organization_events?** The `list_organization_events` tool shows every event tied to your overall Luma account. It gives you a complete audit trail, unlike `list_events`, which only pulls activities associated with your personal user profile. **Can I add guests without having the API key?** No. You need an active Luma Plus subscription to generate and use the necessary API Key for tools like `add_guests_to_event` to function. **What's the difference between list_events and list_organization_events?** `list_events` shows events you personally manage or are associated with your account. `list_organization_events` gives a wider view of all activity across the entire organization, regardless of ownership. **Does Luma MCP Server handle recurring events?** The tools focus on listing and creating specific event instances. While it manages calendar data, complex scheduling logic for multi-year recurrences should be handled in the native Luma platform after using the `create_event` tool. **If I use the `add_guests_to_event` tool with an invalid Event ID, what kind of error will my agent receive?** Your agent receives a specific API validation error confirming the Event UUID doesn't exist. This means your workflow stops immediately, letting you know exactly which event needs correcting before retrying the guest addition. **Does `list_event_guests` handle pagination if an event has thousands of attendees?** Yes, the function supports paginating results. It returns a cursor token with every batch of guests, allowing your AI client to loop through all records efficiently without hitting rate limits. **When I call `create_event`, what are the essential parameters I must provide for Luma to schedule it correctly?** You must supply a unique title, defined date and time range, and an associated organization ID. If these core fields are missing, the tool won't create the event; always validate inputs first. **Does `list_calendar_subscribers` return only email addresses, or does it include subscription metadata?** It returns detailed records for every subscriber. Each entry includes not just the user's email but also their current status and the date they subscribed to your calendar. **Can my AI automatically find the details for a specific event by its ID?** Yes! While the `list_events` tool retrieves all entries, you can use the event metadata to filter and focus on specific records. Your agent will respond with complete metadata for the record in seconds. **How do I find my Luma API Key?** Log in to your Luma account, select your calendar, navigate to **Settings** > **Developer**, and you will find your unique secret token there. Note: You must have Luma Plus. **Can I add guests to an event via the AI?** Absolutely. Use the `add_guests` tool. Provide the event ID and an array of guest objects (email and name), and the agent will register them to your event immediately.