# Meetup MCP

> Meetup MCP Server lets your AI agent handle community administration. You can use the 'Search groups' tool to find new local meetups by keyword, or run 'List upcoming events' to pull a full roster of scheduled dates for any group. It also audits member lists and retrieves specific event metadata using 'Get details for a specific event'.

## Overview
- **Category:** collaboration
- **Price:** Free
- **Tags:** community-building, event-planning, networking, group-management, rsvp-tracking, local-events

## Description

Your AI agent handles all the dirty work managing your community on Meetup. Forget logging into dashboards and clicking through forms; you just tell your client what you need, and it runs the reports. This server lets your agent act like a full-time community coordinator—it'll pull member lists, track events, and find groups without you lifting a finger.

To start finding new circles, use **`search_groups`**. You can query the whole platform by keywords or specific interests to pinpoint new local meetups. If you wanna know what's happening down the line for a group you already belong to, run **`list_upcoming_events`**; that pulls up a chronological roster of future dates and times for the entire community.

Need to deep dive on one specific date? You use **`get_event`**. This tool fetches all the detailed metadata—the full description, location specifics, everything—for a single event when you know its ID or URL. For group governance, you've got **`list_group_members`**. When you run this, it queries and lists every profile belonging to a specific Meetup group ID, letting you audit the roster instantly.

When you need to check your own standing on the platform, use **`get_me`**. This fetches and returns your authenticated user's profile details directly from your Meetup account. It’s quick, reliable data for building out personalized reports.

Your agent takes these capabilities—from finding new groups via **`search_groups`** to auditing member lists using **`list_group_members`**, pulling every future event with **`list_upcoming_events`**, getting deep specs on one date with **`get_event`**, and checking your own profile status via **`get_me`**—and turns complex administrative tasks into simple, actionable data points. You don't have to juggle multiple systems; you just ask for the information, and it shows up.

## Tools

### get_event
Retrieves detailed information for a single, specific Meetup event using its ID or URL.

### get_me
Fetches and returns the authenticated user's profile details from their Meetup account.

### list_group_members
Queries and lists all member profiles associated with a specific Meetup group ID.

### list_upcoming_events
Pulls a chronological list of future events scheduled for an entire Meetup group.

### search_groups
Searches the entire platform to find groups that match given keywords or interests.

## Prompt Examples

**Prompt:** 
```
List upcoming events for the 'ny-tech' group.
```

**Response:** 
```
I've retrieved the upcoming events for ny-tech. You have 3 events scheduled, including 'AI in 2024' and 'Web Dev Night'. Would you like the links for any of them?
```

**Prompt:** 
```
Show me the member list for group 'london-data-science'.
```

**Response:** 
```
I've found the membership list. There are currently 10 recent members visible, including 'Marcus R.' and 'Jane Doe'. Would you like their full profile details?
```

**Prompt:** 
```
Search for groups about 'Machine Learning'.
```

**Response:** 
```
I've identified several groups for 'Machine Learning'. Top matches include 'ML Experts London' and 'Data AI Community'. Which one would you like to explore?
```

## Capabilities

### Discover Groups
Searches Meetup by keywords to find new community groups.

### Audit Roster
Retrieves a list of all current members for a specified group.

### List Future Events
Pulls every upcoming event scheduled for a specific Meetup group.

### Get Event Details
Retrieves the full description and metadata for one single, known event.

### Check User Status
Gets authenticated user information from your Meetup profile.

## Use Cases

### Checking a Competitor's Event Schedule
A marketing team needs to check what events a rival group is promoting next month. They don't know the exact event IDs, so they use `search_groups` first. Once they find the group ID, they run `list_upcoming_events`. The agent returns three dates and their respective URLs immediately.

### Auditing a Board Member Roster
An operations lead needs to verify who belongs to an executive committee within the main 'Tech' group. They use `list_group_members` with the specific Group ID. The agent returns a list of member names and IDs, allowing the user to cross-reference their internal CRM.

### Drafting Event Previews
A content writer needs to write a blog post about an upcoming local meetup. They use `list_upcoming_events` to get the date and title, then feed that specific event's data into `get_event`. The agent returns the full description text, saving hours of manual copy-pasting.

### Finding a Niche Interest Group
A user wants to find groups focused on combining 'AI' and 'Healthcare'. They run `search_groups` with those two keywords. The agent identifies several top matches, like 'Health AI Innovators', allowing the user to pick the most relevant community.

## Benefits

- Check the entire calendar at once. Instead of navigating to a group dashboard, use `list_upcoming_events` to get all future events for a group in one go. You see every date, time, and associated URL.
- Quickly vet new markets. Need to know if 'Data Science' groups exist in Chicago? Run `search_groups` with keywords instead of manually browsing the city’s listing pages.
- Audit membership status instantly. Use `list_group_members` to get a full roster of members for your group, letting you track growth and participation numbers without manual exports.
- Get deep event details fast. When an event link is vague, call `get_event`. This tool gives you the full description and specific metadata needed for cross-posting or marketing copy.
- Understand your user base. Call `get_me` to confirm who you are connected as, ensuring all subsequent calls like group audits use the correct identity.

## How It Works

The bottom line is, your agent treats Meetup like a live API connection, letting you query group data through natural conversation.

1. Subscribe to the server and provide your unique Meetup Access Token.
2. Your AI client initiates a request (e.g., 'List upcoming events for Group X').
3. The MCP Server executes the necessary tool call, returning structured data like event titles, dates, and member IDs.

## Frequently Asked Questions

**How do I find groups using Meetup MCP Server? (search_groups)**
You use the `search_groups` tool and pass in your keywords. This searches across the whole site, letting you identify new communities by topic without browsing.

**What is the difference between listing events and getting an event? (list_upcoming_events vs get_event)**
`list_upcoming_events` gives you a calendar view for a group. `get_event` requires an ID and returns all details for one specific, single event.

**Can I list members of any group with Meetup MCP Server? (list_group_members)**
Yes, you run the `list_group_members` tool. You'll need to provide a valid Group ID for the agent to query the roster.

**Does get_me help with group data? (get_me)**
It doesn't give group data, but it provides your authenticated user profile info. This is often required so the server knows *who* running the audit or search.

**What permissions does the Meetup MCP Server need for the `get_me` tool?**
The access token must grant at least read-only scope across user and group data. This ensures your agent can pull necessary profile details without requiring write or administrative rights.

**If I use `get_event` with an invalid event ID, what does the server do?**
The tool returns a specific error code and message indicating that the requested event ID is inaccessible or doesn't exist. Your agent can catch this precise error to prompt you for correct input.

**Are there rate limits when calling `list_upcoming_events` on large groups?**
Yes, standard API rate limiting applies across all bulk data calls. For extensive event schedules, implement a delay or batch your requests within your AI client's workflow.

**How can I filter members when using `list_group_members`?**
The tool accepts optional parameters like date range or membership status. This allows your agent to pull targeted data, such as only active members who joined in the last quarter.

**How do I find my Meetup Access Token?**
You must perform an OAuth 2.0 flow to generate a Bearer Token for your account. Please refer to the [**Meetup API documentation**](https://www.meetup.com/api/guide/#authentication) for setup steps. Copy and paste it below.

**Can the agent list upcoming events for any group?**
Yes. Use the `list_upcoming_events` tool providing the group's `urlname`. Your agent will retrieve the next 10 events, including their titles and scheduled times.

**Is it possible to search for new communities via the agent?**
Yes. The `search_groups` tool allows your agent to query the Meetup platform for groups matching a specific keyword, helping you discover new community opportunities.