# meetergo MCP

> Meetergo MCP Server lets your AI client manage complex scheduling and appointment logistics directly from chat. You can programmatically create bookings, check multiple users' real-time availability, list all active meetings, or cancel appointments—all without opening a dashboard. It’s full-control orchestration for sales and operations teams.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** appointment-booking, meeting-routing, calendar-sync, lead-qualification, availability-management, workflow-automation

## Description

You're hooking up your AI client to Meetergo, and it lets you manage complex scheduling straight from chat. You don't need to open a dashboard; your agent handles booking logistics by invoking specific tools. It gives full control over appointments for sales teams and operations staff.

***

**Booking Management:**
When you need to schedule something, your agent uses `create_booking` to set up a new meeting appointment for any user or team member. If you gotta track down existing meetings, it pulls the whole list using `list_bookings`, which returns every scheduled appointment in pages. You can also get granular details on one specific event by calling `get_booking` with just an ID. And if things change and a booking gets scrapped, your agent handles that with `cancel_booking`. 

**Availability Checks:**
Figuring out who's free is the core function here. For a single person, your AI client calls `get_availability` to retrieve their specific open slots. If you need an overview of the whole team, it uses `list_availability`, which gives general status across multiple people or entire teams. 

**User and System Data:**
Your agent knows who's in the system. It can pull a full roster with `list_users`, giving you every configured user account name. You don't have to guess; it retrieves all detailed settings for any specific person using `get_user`. For context, it also gets your own profile and connection settings via `get_me`. The whole system status is visible too; `check_meetergo_status` confirms that the meetergo account is connected and running smoothly.

**Meeting Templates and Structures:**
Every meeting has a standard format. To see what templates are available, your agent runs `list_meeting_types`, which pulls every standardized appointment type. If you need deep details on one particular template—say, the 30-minute kickoff call—it uses `get_meeting_type` for that specific name. 

***

Basically, it's a full orchestration layer. You can check user status (`list_users`), get individual availability (`get_availability`), book the meeting (`create_booking`), list all bookings (`list_bookings`), and then cancel one with `cancel_booking`—all without ever opening a web browser.

## Tools

### cancel_booking
Cancels a specific appointment booking in meetergo.

### check_meetergo_status
Verifies the connection and operational status of your meetergo account.

### create_booking
Schedules a new meeting appointment for a user or team member.

### get_availability
Retrieves the specific free slots for one particular user.

### get_booking
Fetches all details for a single, specified booking ID.

### get_me
Retrieves the profile information and settings for the connected user.

### get_meeting_type
Gets detailed information about a specific, named meeting template.

### get_user
Retrieves all configured details for any user account in the system.

### list_availability
Lists the general availability status across multiple users or teams.

### list_bookings
Retrieves a paginated list of all scheduled appointments.

### list_meeting_types
Lists every standardized meeting template available for booking.

### list_users
Provides a full roster and list of all user accounts configured in the system.

## Prompt Examples

**Prompt:** 
```
List all active bookings in meetergo.
```

**Response:** 
```
I've retrieved your bookings. You have 5 active appointments including 'Product Demo' and 'Support Call'. Which one would you like to see attendee details for?
```

**Prompt:** 
```
What meeting templates do I have?
```

**Response:** 
```
I've retrieved your meeting types. You have 3 templates configured: '30 Min Discovery', 'Technical Deep-dive', and 'Onboarding session'.
```

**Prompt:** 
```
Check my availability in meetergo.
```

**Response:** 
```
I've retrieved your availability schedules. You are currently set for 'Standard Business Hours' with exceptions for next Friday.
```

## Capabilities

### Manage bookings
Create new appointments or retrieve full lists of existing meetings using the `create_booking` and `list_bookings` tools.

### Check availability status
Determine if a user is free by calling `get_availability` for specific times, or get an overview of all team member schedules with `list_availability`.

### Retrieve profile and system data
Fetch detailed information about users (`get_user`) or check the overall connection status using `check_meetergo_status`.

### Control meeting templates
See all available standardized appointment types by listing them with `list_meeting_types`, or get details on a specific type using `get_meeting_type`.

## Use Cases

### The urgent follow-up
A client just finished a discovery call. Instead of manually checking the calendar, they ask their agent: 'Book a demo for John next week.' The agent calls `get_availability` to find slots, then uses `create_booking` and confirms the time instantly.

### The departmental sync-up
An Ops Manager needs to know how many meetings are scheduled today. They ask their agent: 'How many bookings do we have for the West Coast team?' The agent runs `list_bookings`, providing a summary without needing dashboard filters.

### The profile update
A user changes roles and needs to confirm which accounts are active. They ask their agent: 'Show me all registered users.' The agent uses `list_users` to provide the full roster, confirming access rights.

### The cleanup crew
A meeting was canceled last minute due to a schedule conflict. Instead of logging in and finding the event, the user just tells their agent: 'Cancel the Demo scheduled for Sarah on Monday.' The agent executes `cancel_booking`.

## Benefits

- Stop switching between apps. You can list all bookings (`list_bookings`) or get specific details for one appointment using `get_booking`—all without leaving your chat window.
- Never guess who's available again. Use `list_availability` to see the team’s overall schedule, or use `get_availability` to check a single person against required time slots.
- Build better lead routing logic. Your agent can first fetch user details (`get_user`) and then use that info to intelligently call `create_booking` for the right rep.
- Maintain compliance with standard meeting formats. You can list every available template via `list_meeting_types`, ensuring consistency when scheduling calls.
- Full lifecycle control: The agent handles everything from initial booking (`create_booking`) through modifications, like canceling a call using `cancel_booking`.

## How It Works

The bottom line is your AI acts like a dedicated office assistant that handles every scheduling detail, so you don't have to check the dashboard manually.

1. First, subscribe to the server and plug in your meetergo API Key (it starts with ak_live:) and User ID.
2. Next, tell your AI client what you need—for example, 'Can I book a demo next Tuesday?'
3. The agent uses these tools: it checks availability (`get_availability`), creates the booking (`create_booking`), and confirms the details for you.

## Frequently Asked Questions

**How do I list all my current bookings using the `list_bookings` tool?**
You ask your agent to 'List all active appointments.' The agent runs `list_bookings`, retrieving a full, paginated list of every scheduled meeting.

**What is the best way to see if a user is free right now? Use `get_availability`?**
Yes. Calling `get_availability` for a specific time window gives you immediate, definitive status checks for one person without listing their entire schedule.

**Can I check the system connection health? What tool should I use?**
Use `check_meetergo_status`. This runs a simple diagnostic that verifies connectivity and ensures your API keys are working before you attempt any complex booking actions.

**How do I see what meeting types are available for booking? Use the `list_meeting_types` tool.**
`list_meeting_types` shows all standard templates configured in meetergo. This prevents you from accidentally scheduling a call using an outdated or incorrect type.

**When should I use the `create_booking` tool, and what details does it require?**
You must provide specific parameters like target user IDs, desired dates/times, and the required meeting type. The tool handles the actual scheduling logic, ensuring the slot is free before confirming the appointment.

**If a booking needs to be canceled, how does the `cancel_booking` tool operate?**
The tool removes the scheduled record immediately. It returns confirmation status or throws an error if the meeting was already modified or removed by another system.

**What does the `get_user` tool provide beyond just availability data?**
It pulls deep user context, including roles, configured settings, and contact details. This allows your agent to understand who they are talking to—beyond just checking if that person is free.

**When listing bookings isn't enough, how do I get comprehensive information using the `get_booking` tool?**
Use this tool when you need deep metadata for a single appointment. It pulls details like internal routing notes and full attendee lists that aren't visible in a simple summary list.

**Can my AI automatically find the details for a specific booking by its ID?**
Yes! Use the `list_bookings` tool. Your agent will respond with complete metadata for the appointments, including participant info and scheduled time in seconds.

**How do I find my meetergo API Key?**
Log in to your meetergo account, navigate to **Settings** > **API Keys**, and you will find your unique secret token (starts with `ak_live:`) there.

**Do I need the User ID?**
Yes, many endpoints require the `x-meetergo-api-user-id` header. You can find your User ID in the profile settings or use the `get_me` tool to retrieve it via the AI.